home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / riptm152.zip / RIPTERM.DOC < prev    next >
Text File  |  1993-04-22  |  177KB  |  3,945 lines
  1.      ┌──────────────────────────────────────────────────────────┐
  2.      │                                                          │░
  3.      │                  ──────────────────────                  │░
  4.      │                     RIPterm v1.52.00                     │░
  5.      │                  ──────────────────────                  │░
  6.      │                                                          │░
  7.      │                                                          │░
  8.      │                      April 21, 1993                      │░
  9.      │                                                          │░
  10.      │                                                          │░
  11.      │  Copyright (c) 1992-93, TeleGrafix Communications, Inc.  │░
  12.      │                   All Rights Reserved                    │░
  13.      │                                                          │░
  14.      └──────────────────────────────────────────────────────────┘░
  15.       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  16.  
  17.  
  18. ┌────────────────────────────────────────────────────────────────────┐
  19. │                         1.0 ■ INTRODUCTION                         │
  20. └────────────────────────────────────────────────────────────────────┘
  21.  
  22. Thank you for trying RIPterm!  A revolutionary new way of viewing
  23. on-line hosts.  This graphics based terminal program is the latest
  24. release of the RIPscrip graphics system terminal program.
  25.  
  26. As a user of RIPterm, you should be aware of its licensing agreement.
  27. The following information details how, when and where RIPterm may be
  28. distributed.  Read this section very carefully.
  29.  
  30.  
  31. ┌────────────────────────────────────────────────────────────────────┐
  32. │                   1.1 ■ DISTRIBUTION INFORMATION                   │
  33. └────────────────────────────────────────────────────────────────────┘
  34.  
  35. You are free to distribute RIPterm to anyone you wish based upon the
  36. following terms and conditions.  RIPterm is FreeWare only in the
  37. sense that you may distribute it governed by the following
  38. restrictions: RIPterm may NOT be freely distributed as part of a
  39. commercial or ShareWare software package without written
  40. authorization from TeleGrafix Communications, Inc. ("TeleGrafix").
  41.  
  42. RIPterm may not be modified in any way without prior written consent
  43. from TeleGrafix.  There are two exceptions to the license that do not
  44. violating the license agreement.  They are:
  45.  
  46.     a) You may supply a RIPTERM.PCX file in 640x350 (16 color) format
  47.        which will be displayed while RIPterm is starting up.  The
  48.        purpose is to offer an advertising mechanism for your host.
  49.  
  50.        The lower 1/7th (50 scan lines) of the intro screen is
  51.        reserved for TeleGrafix's copyright information.  Altering of
  52.        the RIPTERM.EXE file to change the copyright violates this
  53.        license agreement.
  54.  
  55.     b) You may also provide a dialing directory file (RIPTERM.PHO) in
  56.        with your host telephone number entered in.
  57.  
  58. RIPterm may not be distributed unless accompanied by all of the 
  59. following files (either in diskette or archive form):
  60.  
  61.     RIPTERM.EXE    <- The RIPterm executable program
  62.     RIPTERM.HLP    <- RIPterm help file
  63.     RIPTERM.DOC    <- RIPterm documentation (this file)
  64.     RIPTERM.FNT    <- RIPterm system font data file
  65.     RIPTERM.RES    <- RIPterm image resource file
  66.     RIPTERM.PCX    <- RIPterm logo file
  67.     WHATSNEW.DOC   <- Details new things in this release
  68.     DIALCONV.EXE   <- Dialing directory conversion utility
  69.  
  70. If you choose the customization features mentioned previously when
  71. distributing RIPterm, you may provide the following files in addition
  72. to the files listed above:
  73.  
  74.     RIPTERM.PCX    <- Logo file to promote your host
  75.     RIPTERM.PHO    <- A "pre-configured" dialing directory file
  76.     <icon files>   <- Icon files for your host
  77.  
  78.  
  79. ┌────────────────────────────────────────────────────────────────────┐
  80. │                       1.2 ■ LIMITED WARRANTY                       │
  81. └────────────────────────────────────────────────────────────────────┘
  82.  
  83. THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  84. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
  85. IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR
  86. PURPOSE.  TELEGRAFIX COMMUNICATIONS, INC. DOES NOT WARRANT THAT THE
  87. FUNCTIONS CONTAINED IN THIS SOFTWARE WILL MEET YOUR REQUIREMENTS OR
  88. THAT THE OPERATION OF THIS SOFTWARE WILL BE UNINTERRUPTED OR ERROR-
  89. FREE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  90. SOFTWARE IS WITH THE USER.  SHOULD THE SOFTWARE PROVIDED BE DEFECTIVE,
  91. YOU (NOT TELEGRAFIX COMMUNICATIONS, INC.) ASSUME THE ENTIRE COST OF
  92. ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
  93.  
  94. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE
  95. ABOVE EXCLUSION MAY NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU
  96. SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY
  97. FROM STATE TO STATE.
  98.  
  99. IN NO EVENT WILL TELEGRAFIX COMMUNICATIONS, INC. BE LIABLE TO YOU FOR
  100. ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  101. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  102. INABILITY TO USE THE SOFTWARE EVEN IF TELEGRAFIX OR ITS AUTHORIZED
  103. REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES,
  104. OR FOR ANY CLAIM BY ANY OTHER PARTY.
  105.  
  106. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR
  107. INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR
  108. EXCLUSION MAY NOT APPLY TO YOU.
  109.  
  110. YOU MAY NOT SUBLICENSE, ASSIGN OR OTHERWISE TRANSFER THIS LICENSE OR
  111. SOFTWARE EXCEPT AS EXPRESSLY PROVIDED IN THIS AGREEMENT.  ANY ATTEMPT
  112. TO OTHERWISE SUBLICENSE, ASSIGN, OR TRANSFER ANY OF THE RIGHTS,
  113. DUTIES OR OBLIGATIONS HEREUNDER IS EXPRESSLY PROHIBITED AND WILL
  114. TERMINATE THIS AGREEMENT.
  115.  
  116. BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE
  117. READ THIS AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS
  118. TERMS AND CONDITIONS.  YOU FURTHER AGREE THAT IT IS THE COMPLETE AND
  119. EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US, WHICH SUPERSEDES ANY
  120. PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER
  121. COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS
  122. AGREEMENT.
  123.  
  124.  
  125. ┌────────────────────────────────────────────────────────────────────┐
  126. │                         1.3 ■ REQUIREMENTS                         │
  127. └────────────────────────────────────────────────────────────────────┘
  128.  
  129. RIPterm requires that you be using an IBM-PC compatible computer
  130. system running MS-DOS version 3.0 or higher.  You must have 512K of
  131. available RAM or more.  A hard disk is strongly recommended.  You
  132. must have an EGA or higher video adapter a modem connected to serial
  133. port COM1 through COM4.  A mouse and a color monitor are not
  134. required, but are strongly recommended.  This software does not
  135. require Extended (XMS) or Expanded (EMS) memory, but can take
  136. advantage of either if present to improve software performance.
  137.  
  138.  
  139. ┌────────────────────────────────────────────────────────────────────┐
  140. │                    1.4 ■ IMPORTANT INFORMATION                     │
  141. └────────────────────────────────────────────────────────────────────┘
  142.  
  143. Complications may arise currently if you have a SERIAL mouse
  144. installed instead of a BUS mouse.  If you get garbage on the screen
  145. when you move the mouse, then there is a conflict with the MODEM port
  146. and the MOUSE port.  Try deleting the RIPTERM.CNF (RIPterm's
  147. configuration) file and restarting RIPterm.  Once inside RIPterm,
  148. press ALT-O (for Options) and verify that your settings are correct
  149. for your PC's configuration.
  150.  
  151. See APPENDIX A - TROUBLESHOOTING (Section A.2) for more details on
  152. this issue.
  153.  
  154.  
  155. ┌────────────────────────────────────────────────────────────────────┐
  156. │                         1.5 ■ INSTALLATION                         │
  157. └────────────────────────────────────────────────────────────────────┘
  158.  
  159. Create a directory on your hard disk called RIPTERM.  Under that
  160. directory, create another directory called ICONS.  For example:
  161.  
  162.     md \RIPTERM
  163.     md \RIPTERM\ICONS
  164.  
  165. Copy all .ICN, .MSK, and .HIC files into the ICONS directory, and all
  166. remaining files into the RIPTERM directory.  Type RIPTERM to start up
  167. the software.  It will ask you which port your modem is connected to
  168. and the baud rate to use.
  169.  
  170. If you forget to perform any of these steps, or you UNZIP RIPterm
  171. from the distribution archive without extracting sub-directory info,
  172. RIPterm will accommodate the oversight by prompting you to copy
  173. the necessary icon files over to the correct ICONS\ directory.
  174.  
  175.  
  176. ┌────────────────────────────────────────────────────────────────────┐
  177. │                      1.6 ■ GLOSSARY OF TERMS                       │
  178. └────────────────────────────────────────────────────────────────────┘
  179.  
  180. host - refers to the system you are connected to.  This can be a BBS,
  181.        a mainframe, a network application, whatever.
  182.  
  183. icon - an icon is a bit map graphic of varying size.  Icon files may
  184.        end in .ICN, .MSK (mask files), or .HIC (hot icons - used with
  185.        buttons)
  186.  
  187.  
  188. ┌────────────────────────────────────────────────────────────────────┐
  189. │                          1.7 ■ TRADEMARKS                          │
  190. └────────────────────────────────────────────────────────────────────┘
  191.  
  192. RIPterm, RIPscrip, RIPaint, the RIPterm logo, TeleGrafix
  193. Communications, and the TeleGrafix Communications logo are all
  194. trademarks of TeleGrafix Communications, Inc.
  195.  
  196. All other trademarks are trademarks of their respective holders.
  197.  
  198.  
  199. ┌────────────────────────────────────────────────────────────────────┐
  200. │                     2.0 ■ PROGRAM INFORMATION                      │
  201. └────────────────────────────────────────────────────────────────────┘
  202.  
  203. RIPterm has a number of features which make it a useful terminal
  204. program.  Among the many features are the following:
  205.  
  206.     ■ RIPscrip graphics viewing ability
  207.  
  208.     ■ Graphics mode operation - 16-color, 640x350 resolution
  209.  
  210.     ■ Scrollback mode to review text transmitted from host
  211.  
  212.     ■ Editable Keystroke Macros with load/save ability
  213.  
  214.     ■ Log-to-Disk ability
  215.  
  216.     ■ Full ANSI support (plus some VT-102 and VT-52 support)
  217.  
  218.     ■ Supports COM1 through COM4
  219.  
  220.     ■ Custom IRQ and base I/O address settings
  221.  
  222.     ■ Context sensitive, keyword driven help system
  223.  
  224.     ■ Pull-down menu operation as well as complete hot-key support
  225.  
  226.     ■ Fully configurable modem settings
  227.  
  228.     ■ Auto-redial feature
  229.  
  230.     ■ Auto-answer mode
  231.  
  232.     ■ Batch upload/download ability
  233.  
  234.     ■ Auto Z-Modem downloads
  235.  
  236.     ■ Upload ASCII files with optional line/character pacing
  237.  
  238.     ■ Shell to DOS capability
  239.  
  240.     ■ EMS/XMS/overlay support to maximize memory efficiency
  241.  
  242.     ■ Automatically moves icons to the ICONS\ directory if
  243.       there are any in the RIPTERM directory (wrong place).
  244.  
  245.  
  246. ┌────────────────────────────────────────────────────────────────────┐
  247. │                           2.1 ■ FEATURES                           │
  248. └────────────────────────────────────────────────────────────────────┘
  249.  
  250. This section gives more detailed information on RIPterm's features
  251. and options.  To select the HELP option, press F1.
  252.  
  253.  
  254. ┌────────────────────────────────────────────────────────────────────┐
  255. │                    2.1.1 ■ GETTING ON-LINE HELP                    │
  256. └────────────────────────────────────────────────────────────────────┘
  257.  
  258. The help system of RIPterm is easy to use.  To return to the Table of
  259. Contents at any time, click on the "Contents" button at the bottom of
  260. the screen.  If you have navigated through various help screens, you
  261. can back-up to the previous screen by clicking on the "Back" button.
  262. Any words or phrases which are highlighted (light blue on color
  263. monitors) are "keywords" which you can click on to jump to that help
  264. topic.  You may use the UP/DOWN/LEFT/RIGHT keys to navigate through
  265. the help screen's keywords, or you may use the TAB or SHIFT-TAB to
  266. highlight different keywords.  The arrow keys may also be used.  Tap
  267. <ENTER> and the currently selected keyword will be selected, and you
  268. will be taken to that help screen.
  269.  
  270. The Help System Table of Contents may also be accessed by clicking on
  271. "Press F1 for Help" in the Status Bar.
  272.  
  273.  
  274. ┌────────────────────────────────────────────────────────────────────┐
  275. │                      2.1.2 ■ PULL-DOWN MENUS                       │
  276. └────────────────────────────────────────────────────────────────────┘
  277.  
  278. To activate the pull down menus, move the mouse pointer to the top of
  279. the screen and press and hold down the right mouse button.  A menu
  280. bar will appear at the top of the screen.  Move the mouse pointer to
  281. any of these items and a list of menu options will appear below the
  282. menu bar.  At this point, move the mouse down into this list of items
  283. and as you move over different items, they will be highlighted.  To
  284. select any given item, release the right mouse button while the
  285. desired option is highlighted.
  286.  
  287. All options in the pull down menus have corresponding hot-keys that
  288. you can use.  Hot-keys are keyboard short cuts for menu options.
  289. Hot-keys make it so that you do not have to use the mouse to access
  290. the menu.
  291.  
  292. Some menu options are "toggle" items.  If an option is toggled ON,
  293. then you will see a check-mark beside the option indicating that it
  294. is active.  Select these options to toggle the state ON or OFF.
  295.  
  296. You may access the menu system without the mouse by pressing the F10
  297. key.  When selected, the menu bar will appear with one of the menu
  298. items highlighted.  Use the RIGHT and LEFT keys to highlight the
  299. desired menu item, then press the PGDN, DOWN or ENTER keys to display
  300. a list of menu contents for the specified topic.  Use the UP/DOWN
  301. keys to highlight a particular item in the list.  The HOME and END
  302. keys work as you would expect them to.  While a menu is displayed
  303. completely, you may use the LEFT and RIGHT arrow keys to move to an
  304. adjacent menu topic. Pressing PGUP or ESC while a menu is displayed
  305. will remove the list of menu options, and return you to the menu bar
  306. only.  Pressing ESC again will terminate the menu bar mode and return
  307. you to your RIPterm session. If you select options while accessing
  308. the menu with the keyboard, when the option is finished executing,
  309. you will be returned to the pull-down menu so that you can execute
  310. other options quickly.
  311.  
  312. The remaining portion of this section describes each menu, and how
  313. each options functions.
  314.  
  315.  
  316. ┌────────────────────────────────────────────────────────────────────┐
  317. │                    2.1.2.1 ■ THE "PROJECT" MENU                    │
  318. └────────────────────────────────────────────────────────────────────┘
  319.  
  320.     This menu contains many general RIPterm functions:
  321.  
  322.     ┌───────────────┐
  323.     │ ABOUT RIPTERM │
  324.     └───────────────┘
  325.  
  326.     This option will display a help screen displaying the copyright
  327.     information for RIPterm.
  328.  
  329.     ┌─────────────┐
  330.     │ SYSTEM INFO │
  331.     └─────────────┘
  332.  
  333.     This option will display the amount of RAM memory currently
  334.     available as well as the amount of disk space free on the
  335.     currently selected hard disk.
  336.  
  337.     ┌─────────────┐
  338.     │ HELP SYSTEM │
  339.     └─────────────┘
  340.  
  341.     This option will display the help system's Table of Contents.
  342.  
  343.     ┌───────────────┐
  344.     │ HELP ON MENUS │
  345.     └───────────────┘
  346.  
  347.     This option will allow you to view help information on the
  348.     menus.  A window will appear instructing you to select a menu
  349.     option.  Depress the right mouse button and pull down the desired
  350.     menu.  Select an option, and a help screen will appear for that
  351.     item.  When finished, press <ESC> to exit "Menu Help" mode.
  352.  
  353.     ┌───────────────┐
  354.     │ OPEN LOG FILE │
  355.     └───────────────┘
  356.  
  357.     A log file captures text transmitted from the host into a text
  358.     file.  ANSI color codes and RIPscrip graphics commands are
  359.     filtered out for your convenience.  This command can be very
  360.     powerful on hosts where you want to save data coming across the
  361.     screen to a file that you can read when off-line, at your leisure.
  362.     A log file can be as big as you want, up to the amount of
  363.     currently available disk space.
  364.  
  365.     To open a log file, select "Open Log File" from the menu.  You
  366.     will be prompted for a filename.  When a log file is open, the
  367.     menu option "Open Log File" changes to "Pause/Close Log", and the
  368.     status bar will show the log file name in the third spot from the
  369.     left, where the terminal emulation is normally displayed.
  370.  
  371.     If a log file is currently open, selecting "Pause/Close Log" from
  372.     the menu, or clicking on the filename in the status bar will give
  373.     you the option to either pause the log, or to close the file.
  374.     Pausing "suspends" logging to disk temporarily so that you can do
  375.     things without saving them to the log file.  If you are currently
  376.     paused, selecting "Pause/Close Log" again or clicking on the
  377.     filename in the status bar will prompt you to either resume, or
  378.     close the log.
  379.  
  380.     If a log file is open, and you choose EXIT RIPTERM, it will be
  381.     automatically closed.
  382.  
  383.     ┌─────────────┐
  384.     │ JUMP TO DOS │
  385.     └─────────────┘
  386.  
  387.     The "Jump to DOS" feature allows you to shell out to an MS-DOS
  388.     command line while remaining in RIPterm.  You would use this if
  389.     you wanted to obtain a DOS directory, or to run an editor, or use
  390.     DOS in general.  To return to RIPterm from the DOS command line,
  391.     type "EXIT".
  392.  
  393.     RIPterm will display a special DOS prompt indicating that are
  394.     currently running RIPterm, but executing a DOS shell.  You may
  395.     use any disk drive you want, or change directories.  When you
  396.     type "EXIT", RIPterm will return to your default RIPterm
  397.     directory so that it can re-load files for you.  When you return
  398.     to your RIPterm session, the current graphics screen is restored
  399.     as well as any mouse fields, or other parameters.
  400.  
  401.     ┌──────┐
  402.     │ EXIT │
  403.     └──────┘
  404.  
  405.     This exits RIPterm and return you to DOS.  If your modem
  406.     configuration is set to "modem dialing", and you are currently
  407.     on-line, a dialog box will appear asking if you wish to hang-up
  408.     before exiting.  If you choose NO at this option, you will remain
  409.     on-line even after you have exited to DOS.  Use this option with
  410.     caution, as if you forget that you are on-line, you could charge
  411.     up a considerable long distance bill.
  412.  
  413.  
  414. ┌────────────────────────────────────────────────────────────────────┐
  415. │                    2.1.2.2 ■ THE "OPTIONS" MENU                    │
  416. └────────────────────────────────────────────────────────────────────┘
  417.  
  418.     This menu contains many options that can be used to alter
  419.     RIPterm's basic configuration, and mode of operation:
  420.  
  421.     ┌─────────────┐
  422.     │ STATUS LINE │
  423.     └─────────────┘
  424.  
  425.     The status line displays various important information about the
  426.     current State of RIPterm.  Information displayed left to right:
  427.  
  428.         ┌───────────┬─────────────┬──────────┬─────────────────┬
  429.         │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
  430.         └───────────┴─────────────┴──────────┴─────────────────┴
  431.              (1)          (2)          (3)      (4)      (5)
  432.  
  433.         ┬──────┬──────────────────┬─────────┐
  434.         │ COM1 │ RIPterm v1.51.00 │ Offline │
  435.         ┴──────┴──────────────────┴─────────┘
  436.           (6)           (7)           (8)
  437.  
  438.         (1) How to get the help system table of contents
  439.  
  440.         (2) How to use the keyboard only to select from the menus
  441.  
  442.         (3) What terminal emulation is in use, or the name of the log
  443.             file if one has been opened
  444.  
  445.         (4) The baud rate, parity setting, data bits and stop bits
  446.  
  447.         (5) Full-duplex (FDX) or half-duplex (HDX)settings
  448.  
  449.         (6) The COM port that is currently in use
  450.  
  451.         (7) The current version number of RIPterm
  452.  
  453.         (8) Whether you are "on-line" or "off-line"
  454.  
  455.     To display or hide the status line, press ALT-SPACE.
  456.  
  457.     ┌──────────────┐
  458.     │ ZOOM WINDOWS │
  459.     └──────────────┘
  460.  
  461.     In RIPterm, whenever a window or dialog box pops up on the
  462.     screen, it will "zoom in" and "zoom out" giving a visual feeling
  463.     of the window opening or closing.  This will slow down operation
  464.     of the windowing system a small amount.  For optimal performance
  465.     of RIPterm, toggle zoom windows off.  However, the visual
  466.     impression of windows opening or closing can be quite useful.
  467.  
  468.     ┌──────────────────┐
  469.     │ 101-KEY KEYBOARD │
  470.     └──────────────────┘
  471.  
  472.     This mode is used in the "doorway mode" (see below).  It allows
  473.     you to send extended 101-key keyboard codes to the doorway system
  474.     running on the host.  This mode is only available on AT
  475.     computers with a 101-key enhanced AT keyboard.  If this option
  476.     locks up your system, disable it.
  477.  
  478.     This value is part of the RIPterm setup, saved in RIPTERM.CNF.
  479.     If you set this option ON, and it locks your system, and your
  480.     system locks whenever you start up RIPterm, then the option has
  481.     been saved to your setup.  You should run RIPterm with the -E
  482.     option, like this:
  483.  
  484.         RIPTERM -E
  485.  
  486.     The first thing you should do is disable the 101-key keyboard
  487.     option and save your setup with ALT-S.  The -E option overrides
  488.     Enhanced 101-key keyboard support for the duration of the current
  489.     session of RIPterm.
  490.  
  491.     ┌────────────────┐
  492.     │ BUTTON HOTKEYS │
  493.     └────────────────┘
  494.  
  495.     A new option is available to the RIPterm user: Button hotkey
  496.     release mode.  This allows the user to determine whether his
  497.     keystrokes should be checked with the BBS buttons or not for
  498.     activation.  In other words, if the BBS places a button on the
  499.     screen like this:
  500.  
  501.                       ┌────────────────┐
  502.                       │                │
  503.                       │  (E)nter name  │
  504.                       │                │
  505.                       └────────────────┘
  506.  
  507.     ...where the hotkey for the button is "E", simply pressing the
  508.     "E" key on your keyboard would normally activate this button.
  509.     This may not be desirable if you're trying to send a message to
  510.     another user with the letter "E" in it.  Now, there's a way
  511.     around this: Hotkey Release Mode.
  512.  
  513.     Hotkey Release mode is linked to your SCROLL-LOCK key on your
  514.     keyboard.  If Scroll Lock is lit, then hotkeys are processed.
  515.     If it is not lit, then the character will be sent to the BBS
  516.     directly, bypassing any button hotkeys.
  517.  
  518.     ┌───────────────────────┐
  519.     │ CLEAR GRAPHICS WINDOW │
  520.     └───────────────────────┘
  521.  
  522.     RIPterm uses two windows in RIPscrip graphics mode, a graphics
  523.     window and a text window.  The text window is where all
  524.     non-graphics data is displayed.  The graphics window is where all
  525.     graphical RIPscrip commands are displayed.
  526.  
  527.     Choose this option to clear the graphics window only.  If the
  528.     graphics window overlaps the text window, then some of the text
  529.     may be erased in the process.  The window is cleared to the
  530.     current background color, which by default is BLACK.
  531.  
  532.     NOTE: The graphics window is ALWAYS set to the full screen.
  533.  
  534.     ┌───────────────────────┐
  535.     │ CLEAR THE TEXT WINDOW │
  536.     └───────────────────────┘
  537.  
  538.     RIPterm uses two windows in RIPscrip graphics mode, a graphics
  539.     window and a text window.  The graphics window is where all
  540.     graphical RIPscrip commands are displayed.  The text window is
  541.     where all non-graphics data is displayed.
  542.  
  543.     Choose this option to clear the text window only.  If the text
  544.     window overlaps the graphics window, then some of the graphics
  545.     may be erased in the process.  The window is cleared to BLACK and
  546.     the cursor moved to the upper left corner of the window.
  547.  
  548.     NOTE: The text window, by default, is full screen.  This may be
  549.           changed by RIPscrip graphics commands.
  550.  
  551.     ┌───────────────────┐
  552.     │ RESET ALL WINDOWS │
  553.     └───────────────────┘
  554.  
  555.     This command will reset the text and graphics windows to full
  556.     screen.  In addition, the screen is cleared and the cursor moved
  557.     to the upper left hand corner of the screen.  This is equivalent
  558.     to a clear screen command in other software packages.  The color
  559.     palette is reset to the standard 16 ANSI colors, and the font is
  560.     reset to the system default you have selected.
  561.  
  562.     ┌────────────────────────┐
  563.     │ VIEW SCROLLBACK BUFFER │
  564.     └────────────────────────┘
  565.  
  566.     This option will activate the text scrollback system.  This
  567.     allows you to view previously displayed text information that has
  568.     come across the modem.  You may set the scrollback buffer size
  569.     to 5k - 64k of memory.
  570.  
  571.     Within scrollback, you may choose from the following options:
  572.  
  573.          SAVE buffer page to a text file
  574.          SAVE entire buffer to a text file
  575.          PRINT the current buffer page, or the entire buffer
  576.          SEARCH for a particular piece of text
  577.          Search AGAIN for a previously searched for text string
  578.  
  579.     At the top of the scrollback screen are buttons for the above
  580.     commands.  In addition, there are buttons for scrolling up and
  581.     down, paging up and down, or moving to the beginning or end of
  582.     the buffer.
  583.  
  584.     NOTE: The scrollback buffer filters out ANSI color codes and
  585.           RIPscrip graphics for an uncluttered text display.
  586.  
  587.     ┌─────────────────────┐
  588.     │ SET SCROLLBACK SIZE │
  589.     └─────────────────────┘
  590.  
  591.     This option sets how much memory RIPterm should use for the
  592.     scrollback buffer.  The valid settings are from 5k - 64k of
  593.     memory.  Depending on how much conventional memory you have on
  594.     your computer, this may limit the amount of memory you can
  595.     allocate to scrollback.  We recommend that you set it to
  596.     somewhere around 32k unless you know that your PC has quite a bit
  597.     of its 640k memory free for use.  If you have numerous memory
  598.     resident programs (TSR's) loaded, you may need to drop the size
  599.     of your scrollback buffer to a smaller value for proper
  600.     operation of RIPterm.
  601.  
  602.     If RIPterm runs out of memory, it will begin to discard old
  603.     scrollback buffer information until it can satisfy the memory
  604.     request.
  605.  
  606.     ┌────────────────────────┐
  607.     │ KEYSTROKE MACRO EDITOR │
  608.     └────────────────────────┘
  609.  
  610.     Macros are functions that you can define to perform short-cut
  611.     operations on the host.  For example, you can instruct
  612.     RIPterm to make the F5 key type your User-ID and press <ENTER>
  613.     for you.  This would allow you to log-on quickly by simply
  614.     pressing a single key. RIPterm's macro system is easy to use, and
  615.     very powerful!  You can save your macro keys to the default macro
  616.     file (RIPTERM.KEY), or if you need to have multiple macro
  617.     configurations, you can save macros to different files.
  618.  
  619.     ┌─────────────┐
  620.     │ SYSTEM FONT │
  621.     └─────────────┘
  622.  
  623.     The System Font allows you to select the font that is used in
  624.     text/ANSI mode.  It does not have any effect on the graphics
  625.     shown. Any subsequent text/ANSI displayed on the screen will
  626.     appear in the chosen system font unless the host explicitly tells
  627.     it to use another font for the text window.
  628.  
  629.     This mode allows you to specify how "large" text is when you are
  630.     in full-screen text mode.  You have five separate System Fonts to
  631.     choose from.  They are:
  632.  
  633.             80x43 - default
  634.             80x25 - normal DOS screen size
  635.             40x25 - low-resolution font
  636.             91x43 - get more columns of text at once
  637.             91x25 - get more columns of text at once
  638.  
  639.     ┌──────────────┐
  640.     │ DOORWAY MODE │
  641.     └──────────────┘
  642.  
  643.     This mode is of use on a number of host packages that take
  644.     advantage of "Doors".  When in Doorway mode, any keystroke that
  645.     you enter on your keyboard is transmitted to the host regardless
  646.     of the fact that the keystroke might be a menu shortcut, or
  647.     something that RIPterm would normally process locally.  This
  648.     allows you to use special keystrokes (like INSERT, DELETE, PGUP,
  649.     Function Keys, etc.) on a host program that can take advantage of
  650.     it. The most popular program that takes advantage of this mode is
  651.     DOORWAY by Marshall Dudley.
  652.  
  653.         PROGRAMMER'S NOTE:
  654.  
  655.             For the technical minded who want to know how this works,
  656.             this is what's going on:
  657.  
  658.               ■ The keystroke is recorded using BIOS interrupt
  659.                 0x16, sub-function 0x00 for non-101-key keyboards,
  660.                 or sub-function 0x10 for 101-key keyboards.
  661.  
  662.               ■ If register AL contains a value (the ASCII
  663.                 character), and AH is equal to 0, then it is
  664.                 sent to the host by transmitting the character
  665.                 directly over the comm port.
  666.  
  667.               ■ If AH is not 0, then transmit the contents of AH
  668.                 instead to the host by transmitting a null (0),
  669.                 then the contents of AH.  If AL == E0, and AH != 0,
  670.                 then it is an enhanced 101-key scancode and should
  671.                 be sent to the host as a null (0), followed by an
  672.                 0xE0, then followed by the raw scan code.
  673.  
  674.     ┌───────────────┐
  675.     │ DISABLE BEEPS │
  676.     └───────────────┘
  677.  
  678.     This will disable the Beep character (ASCII character 7, BEL)
  679.     from being played on the PC speaker when received from the host.
  680.     This makes RIPterm "quiet" when you want it to be.  This does not
  681.     override all sounds; just BEEP characters received from the host.
  682.  
  683.     ┌────────────────────┐
  684.     │ DROP DTR TO HANGUP │
  685.     └────────────────────┘
  686.  
  687.     This option will lower DTR for approximately two seconds to
  688.     disconnect the modem.  If for some reason, the modem still hasn't
  689.     disconnected, hang-up will default to the typical method of
  690.     issuing a +++, followed by an ATH to hang-up the modem.  If after
  691.     all hang-up processing is complete, and the Modem still hasn't
  692.     disconnected, a message saying "Hang-up Failed" will be displayed.
  693.  
  694.     ┌────────────────────┐
  695.     │ MOUSE FIELD SELECT │
  696.     └────────────────────┘
  697.  
  698.     This option, when check marked, will use TAB and SHIFT-TAB to
  699.     select, in order, the mouse fields defined on the screen.
  700.  
  701.     If this item is not check marked, the TAB character (control-I) is
  702.     transmitted to the host.
  703.  
  704.  
  705. ┌────────────────────────────────────────────────────────────────────┐
  706. │                     2.1.2.3 ■ THE "MODEM" MENU                     │
  707. └────────────────────────────────────────────────────────────────────┘
  708.  
  709. The modem menu contains options that alter the way the modem works
  710. with RIPterm.  Depending on what type of host you are trying to dial,
  711. or what configuration your modem is set to, you may have to alter the
  712. modem's configuration to best suit your own needs.
  713.  
  714.     ┌────────────────┐
  715.     │ MODEM SETTINGS │
  716.     └────────────────┘
  717.  
  718.     This dialog box will allow you to modify your modem configuration.
  719.     You may alter the modem initialization commands, the auto-answer
  720.     string or the modem reset command string.  These options use
  721.     standard Hayes-compatible modem commands.  If you wish to insert a
  722.     "pause" into the command, simply insert a comma (,).
  723.  
  724.     In addition to modem commands, you may set the current COM port,
  725.     the data bits, stop bits, parity setting and baud rate.  Standard
  726.     settings are either 8 data bits, 1 stop bit and NO parity (8N1),
  727.     or 7 data bits, 1 stop bit and EVEN parity (7E1).  Additional
  728.     options allow you to specify touch tone or rotary (pulse)
  729.     dialing, the number of seconds to wait for a connection (redial
  730.     time), whether to add CR/LF combinations and whether RIPterm is
  731.     connected directly to a modem or not.  You may also specify flow
  732.     control for the serial port as either XON/XOFF (software flow
  733.     control), or RTS/CTS control (hardware control - more reliable).
  734.     If you specify RTS/CTS flow control, make sure your modem cable
  735.     can support the specific signals that would make this mode work
  736.     properly.  Most commonly available serial cables support this
  737.     feature now.  If you have an internal modem, then this mode
  738.     should work for you automatically.
  739.  
  740.     One final option on this dialog box is the "Use Modem" option. If
  741.     selected (the default), then RIPterm assumes it is connected to a
  742.     modem.  If it is disabled, then RIPterm thinks it is connected to
  743.     another computer directly using a modem eliminator cable (also
  744.     known as a "NULL MODEM" cable).
  745.  
  746.     To alter the serial port IRQ settings, choose the INTERRUPT SETUP
  747.     option.  To alter serial port addresses, choose the option SERIAL
  748.     ADDRESSES from the OPTIONS menu.
  749.  
  750.     These settings are part of the setup, so once you alter them, you
  751.     should choose the SAVE SETUP option to make them permanent.
  752.  
  753.     ┌────────────┐
  754.     │ SAVE SETUP │
  755.     └────────────┘
  756.  
  757.     This option will save a number of configuration parameters for
  758.     RIPterm.  Among the various items maintained in the Setup are:
  759.  
  760.         ■ Modem Setup
  761.  
  762.         ■ Zooming Windows ON/OFF
  763.  
  764.         ■ Status Bar ON/OFF
  765.  
  766.         ■ Serial Port Interrupt settings   (for all four ports)
  767.  
  768.         ■ Serial Port I/O Address settings (for all four ports)
  769.  
  770.         ■ CR/LF settings
  771.  
  772.         ■ Echo Keystrokes setting (duplex)
  773.  
  774.         ■ Scrollback Buffer Size
  775.  
  776.         ■ Dialing Directory TOGGLE status
  777.  
  778.         ■ Use DTR to Hang-up status
  779.  
  780.         ■ Data Security status
  781.  
  782.         ■ 101-key Enhanced Keyboard status
  783.  
  784.         ■ ASCII upload settings
  785.  
  786.         ■ Default System Font
  787.  
  788.         ■ Beep ON/OFF status
  789.  
  790.     Each time you load RIPterm, the setup is loaded and used for the
  791.     current session.
  792.  
  793.     Setup information is contained in a file called RIPTERM.CNF by
  794.     default.  This can be altered by using the -S parameter when
  795.     starting up RIPterm.  This option instructs RIPterm to use an
  796.     alternate setup file (e.g., RIPTERM -Smysetup.cnf).
  797.  
  798.     ┌─────────────────┐
  799.     │ ECHO KEYSTROKES │
  800.     └─────────────────┘
  801.  
  802.     This command will toggle whether RIPterm should echo keystrokes
  803.     to the terminal locally, or let the host perform the echoing.
  804.     Normally, the host will do this for you, so echo is OFF by
  805.     default.  In some situations though, you may wish to toggle ECHO
  806.     ON.  One such situation is if you are directly connected to
  807.     another person's computer via modem and are typing to them in a
  808.     "chat-like" manner.
  809.  
  810.     ┌───────────────────┐
  811.     │ DIALING DIRECTORY │
  812.     └───────────────────┘
  813.  
  814.     This option displays the current dialing directory on your
  815.     screen.  From this dialog box, you may dial, edit or otherwise
  816.     manipulate any of the dialing directory entries in any way you
  817.     wish. There is a complete section of this document devoted
  818.     specifically to the dialing directory.  Read on for details.
  819.  
  820.     You may also access this mode by clicking on the "off-line" field
  821.     of the status bar.  This field will automatically change to
  822.     "on-line" when connected to a host.  Clicking on this field when
  823.     on-line will activate the hang-up option.
  824.  
  825.     ┌───────────────────┐
  826.     │ HANG-UP THE MODEM │
  827.     └───────────────────┘
  828.  
  829.     This option will attempt to disconnect the modem, thus logging
  830.     you off of whatever host you are connected to.
  831.  
  832.     You may also hang-up the modem by clicking on the "On-line" field
  833.     of the Status Bar.
  834.  
  835.     If for some reason, RIPterm was unable to successfully disconnect
  836.     the modem, the message "Hang-up Failed" will be displayed.
  837.  
  838.     ┌───────────┐
  839.     │ ADD CR/LF │
  840.     └───────────┘
  841.  
  842.     This option will add CR/LF combinations at the end of text lines.
  843.     Normally, this is not necessary.  Some hosts however, require
  844.     that CR/LF's be ON for you to see text properly.  Normally, this
  845.     option is OFF.  You may toggle it ON if need be.
  846.  
  847.     If text coming across the modem does not move to the next line,
  848.     then you need to turn this option ON.  If every line of text is
  849.     separated by a blank line, then you need to toggle this OFF.
  850.  
  851.     ┌──────────────────┐
  852.     │ DIALING PREFIXES │
  853.     └──────────────────┘
  854.  
  855.     This option allows you to alter your dialing Prefix and Suffix
  856.     settings.  These settings are used for every system you try to
  857.     dial to begin the dialing operation (prefix), and to finish the
  858.     dialing process (suffix).  You are allowed up to three choices
  859.     of each, and any one of those three entries can be set to be
  860.     the "Default" prefix/suffix.  See the Dialing Prefix/Suffix 
  861.     section below for more details.
  862.  
  863.     ┌─────────────────────────────┐
  864.     │ SERIAL PORT INTERRUPT SETUP │
  865.     └─────────────────────────────┘
  866.  
  867.     THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
  868.     FAMILIAR WITH IBM-PC INTERRUPTS AND HARDWARE SETUP!
  869.  
  870.     This option allows you to customize the Interrupt (IRQ) settings
  871.     for each of your four COM ports.  Normally this isn't necessary.
  872.     However, some PC's have special configurations that require the
  873.     terminal's setup to be altered if the serial ports are to
  874.     function properly.
  875.  
  876.     There are five different interrupts that can be selected for each
  877.     COM port (2, 3, 4, 5, and 7).  If two serial ports in the
  878.     computer use the same interrupt (i.e., a conflict), then problems
  879.     may arise.
  880.  
  881.     ┌───────────────────────────┐
  882.     │ SERIAL PORT ADDRESS SETUP │
  883.     └───────────────────────────┘
  884.  
  885.     THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
  886.     FAMILIAR WITH IBM-PC BASE I/O ADDRESSES AND HARDWARE SETUP!
  887.  
  888.     This option allows you to customize the base I/O addresses of the
  889.     four COM ports that RIPterm can utilize.  Normally, you will not
  890.     need to alter these settings.  If you are a PC technician, or you
  891.     have serial port configuration that doesn't comply with the
  892.     COM1-COM4 standards, you may need to alter your addresses for
  893.     these ports to make RIPterm function properly.  The standard
  894.     addresses for COM1-4 are as follows on an AT compatible computer:
  895.  
  896.  
  897.             Normal IBM-AT                  MicroChannel
  898.                 (ISA)                         (PS/2)
  899.  
  900.         PORT    ADDRESS    IRQ        PORT    ADDRESS    IRQ
  901.         ----------------------        ----------------------
  902.         COM1      3F8       4         COM1      3F8       4
  903.         COM2      2F8       3         COM2      2F8       3
  904.         COM3      3E8       4         COM3      3220      3
  905.         COM4      2E8       3         COM4      3228      3
  906.  
  907.  
  908.     NOTE: The first time you install RIPterm, it will auto-sense if you
  909.           are on a MicroChannel machine, and if so, will attempt to
  910.           customize the Address and IRQ's for COM3 and COM4 itself.
  911.  
  912.     ┌──────────────────┐
  913.     │ INITIALIZE MODEM │
  914.     └──────────────────┘
  915.  
  916.     Choosing this option will reset the modem, and send the modem
  917.     initialization string to the modem.  This will effectively reset
  918.     the modem to the configured default settings.
  919.  
  920.     The commands sent to the modem can be altered by choosing modem
  921.     settings from the Modem menu, or by pressing ALT-O.
  922.  
  923.     ┌───────────────────┐
  924.     │ MODEM AUTO-ANSWER │
  925.     └───────────────────┘
  926.  
  927.     This command will transmit the modem auto-answer command string
  928.     to the modem.  This command instructs the modem to answer the
  929.     phone after a certain number of rings (one ring by default).
  930.  
  931.     The commands sent to the modem can be altered by choosing modem
  932.     settings from the Modem menu, or by pressing ALT-O.
  933.  
  934.     ┌────────────────┐
  935.     │ MANUAL DIALING │
  936.     └────────────────┘
  937.  
  938.     This command will prompt you to enter the telephone number to
  939.     dial.  You may enter any digits from 0-9.  Hyphens are ignored.
  940.     If you need to obtain a delay before continuing the rest of the
  941.     phone number, enter a comma (,) for a 1/2 second pause. After
  942.     entering the phone number, the DIALING window will appear showing
  943.     you the current status of RIPterm as it dials the modem.
  944.  
  945.     ┌─────────────┐
  946.     │ VT-102 MODE │
  947.     └─────────────┘
  948.  
  949.     This command enabled the VT-102 terminal emulation mode.  This
  950.     makes the following keystrokes send something to the Host:
  951.  
  952.                               F1 ...  ESC [ M
  953.                               F2 ...  ESC [ N
  954.                               F3 ...  ESC [ O
  955.                               F4 ...  ESC [ P
  956.                               F5 ...  ESC [ Q
  957.                               F6 ...  ESC [ R
  958.                               F7 ...  ESC [ S
  959.                               F8 ...  ESC [ T
  960.                               F9 ...  ESC [ U
  961.                              F10 ...  ESC [ V
  962.                             PGUP ...  ESC [ I
  963.                             PGDN ...  ESC [ G
  964.                             HOME ...  ESC [ H
  965.                              END ...  ESC [ F
  966.                           INSERT ...  ESC [ L
  967.                        CURSOR UP ...  ESC [ A
  968.                        CURSOR DN ...  ESC [ B
  969.                      CURSOR LEFT ...  ESC [ C
  970.                     CURSOR RIGHT ...  ESC [ D
  971.  
  972.     In addition, many ANSI escape sequences function slightly differently
  973.     than in normal ANSI mode.  When in this mode, RIPterm tries to act
  974.     like a VT-102 compatible terminal.
  975.  
  976.  
  977.  
  978. ┌────────────────────────────────────────────────────────────────────┐
  979. │                   2.1.2.4 ■ THE "TRANSFER" MENU                    │
  980. └────────────────────────────────────────────────────────────────────┘
  981.  
  982. This menu contains options for transferring files TO (downloading) or
  983. FROM (uploading) your system.  These commands make use of File
  984. Transfer Protocols (see below).
  985.  
  986.     ┌─────────────────┐
  987.     │ DOWNLOAD A FILE │
  988.     └─────────────────┘
  989.  
  990.     This command downloads (receives) a file from the host to your
  991.     system.  This is done by what's called a "protocol" transfer.  A
  992.     protocol is like a language that humans speak.  There are a
  993.     number of languages like French, English, and Italian.  If two
  994.     people are speaking in different languages, the net result is
  995.     that no communication occurs.  The same goes for protocols.  Both
  996.     the host and the terminal (RIPterm) must use the same protocol if
  997.     they are to communicate properly.
  998.  
  999.     To download a file, instruct the host which file you want to
  1000.     transfer. Select a protocol from the menu of available protocols.
  1001.     When the host says "Ready to download..." or "Ready to send...",
  1002.     choose the download option of RIPterm and select the same
  1003.     protocol that you chose on the host.  Enter a filename to save to
  1004.     your local hard disk and the file transfer will commence.  When
  1005.     the transfer is done, you will be returned to terminal mode and
  1006.     the file will either exist on your hard disk, or will be
  1007.     incomplete or missing entirely if an error occurred.
  1008.  
  1009.     The currently supported protocols are:
  1010.  
  1011.          X-Modem (checksum)
  1012.          X-Modem (CRC)
  1013.          X-Modem-1K
  1014.          X-Modem-G-1K
  1015.          Y-Modem-Batch
  1016.          Y-Modem-G
  1017.          Z-Modem
  1018.          Kermit
  1019.          ASCII (text files only!)
  1020.  
  1021.     ┌───────────────┐
  1022.     │ UPLOAD A FILE │
  1023.     └───────────────┘
  1024.  
  1025.     This command upload (send) a file to the host from your system.
  1026.     This is done by what's called a "protocol" transfer.  A protocol
  1027.     is like a language that humans speak.  There are a number of
  1028.     languages like French, English, and Italian.  If two people are
  1029.     speaking in different languages, the net result is that no
  1030.     communication occurs. The same goes for protocols.  Both the host
  1031.     and the terminal (RIPterm) must use the same protocol if they are
  1032.     to communicate properly.
  1033.  
  1034.     To upload a file, instruct the host to upload, and give the host
  1035.     a filename.  Select a protocol from the menu of available
  1036.     protocols.  When the host says "Ready to upload..." or "Ready to
  1037.     receive...", choose the upload option of RIPterm and select the
  1038.     corresponding protocol that you chose on the host.  Enter a
  1039.     filename to send from your local hard disk and the file transfer
  1040.     will begin.  When the transfer is done, you will be returned to
  1041.     terminal mode and if there were no errors in transmission, the
  1042.     file will exist on the host.
  1043.  
  1044.     The currently supported protocols are:
  1045.  
  1046.          X-Modem (checksum)
  1047.          X-Modem (CRC)
  1048.          X-Modem-1K
  1049.          X-Modem-G-1K
  1050.          Y-Modem-Batch
  1051.          Y-Modem-G
  1052.          Z-Modem
  1053.          Kermit
  1054.          ASCII (text files only!)
  1055.  
  1056.     ┌───────────────────────┐
  1057.     │ ASCII UPLOAD SETTINGS │
  1058.     └───────────────────────┘
  1059.  
  1060.     This option modifies the default settings for ASCII (text)
  1061.     uploads.  Some hosts are picky about how fast they can take text
  1062.     data being uploaded to them. With this in mind, you can set a
  1063.     short delay in between each line of text sent to the host, and/or
  1064.     you can set a delay in between each character sent to the host.
  1065.     Fine tuning this can make ASCII text uploads fast and the most
  1066.     optimized they can be for the host you call.
  1067.  
  1068.  
  1069. ┌────────────────────────────────────────────────────────────────────┐
  1070. │                     2.1.2.5 ■ THE "DATA" MENU                      │
  1071. └────────────────────────────────────────────────────────────────────┘
  1072.  
  1073.     ┌─────────────────┐
  1074.     │ CREATE VARIABLE │
  1075.     └─────────────────┘
  1076.  
  1077.     This option enters a piece of information into the RIPterm
  1078.     database.  This information will be saved for future use by
  1079.     either yourself or by a host.  You may store just about any piece
  1080.     of information in this database.  Each piece of information is
  1081.     associated with a "name".  Any information entered must be from
  1082.     1-60 characters in length.  The name of the information (also
  1083.     called the variable name), is from 3-12 characters in length.  An
  1084.     example of this might be:
  1085.  
  1086.         Variable        Information Stored in variable
  1087.         --------------  ------------------------------
  1088.         FIRST_NAME      John
  1089.         LAST_NAME       Doe
  1090.         ADDRESS         123 Anywhere Street
  1091.         PHONE_NUMBER    555-1212
  1092.  
  1093.     You may choose to save a data variable either to internal memory,
  1094.     or to the permanent database.  This database is "indexed" for
  1095.     high speed access of information.  In the event that the Index
  1096.     becomes corrupted due to a power failure or something of that
  1097.     nature, it will be automatically re-indexed for you.
  1098.  
  1099.     ┌────────────────┐
  1100.     │ SHOW VARIABLES │
  1101.     └────────────────┘
  1102.  
  1103.     This option displays all text variables that have been stored to
  1104.     the local RIPTERM.DB database file.  All variables are listed to
  1105.     the current text window, but are not sent to the host.  This
  1106.     allows you to see what is currently in your database.
  1107.  
  1108.     NOTE: The variables are appended to the scrollback buffer.  You
  1109.           can view them by selecting text scrollback from the
  1110.           Options menu, or pressing ALT-B.
  1111.  
  1112.     ┌────────────────────┐
  1113.     │ BUILT-IN VARIABLES │
  1114.     └────────────────────┘
  1115.  
  1116.     This displays the contents of all text variables that are built
  1117.     into RIPterm.  Some variables are pre-defined in the sense that
  1118.     RIPterm doesn't need you to instruct it with information.  Among
  1119.     the various pre-defined variables are things like $DATE$, $TIME$,
  1120.     and other such variables that change frequently.  Some variables
  1121.     do not contain valid text data due to their nature.  These might
  1122.     include variables like $SBARON$, or $SBAROFF$ which turn display
  1123.     or hide the Status Bar.  When listing these variables, the
  1124.     contents are listed as blank.
  1125.  
  1126.     NOTE: The variables are appended to the scrollback buffer.  You
  1127.           can view them by selecting text scrollback from the
  1128.           Options menu, or pressing ALT-B.
  1129.  
  1130.     ┌───────────────┐
  1131.     │ DATA SECURITY │
  1132.     └───────────────┘
  1133.  
  1134.     This option gives you control over host data queries to your
  1135.     system.  This option defaults to ON, giving you the ability to
  1136.     scrutinize any queries by the host to ask your system for a piece
  1137.     of information.  This does not apply to pre-defined text
  1138.     variables, just variables that contain data that you've entered.
  1139.  
  1140.     How does this apply to you?  Well, RIPscrip has the inherent
  1141.     ability to pop-up dialog boxes onto your screen asking you for a
  1142.     piece of information.  Depending on the request, this information
  1143.     might be stored to your local RIPterm database for future use (by
  1144.     the same host, or potentially another).  This option exists so
  1145.     that if a host asks your terminal for a piece of information, you
  1146.     have the ability to intervene (i.e., prevent the information from
  1147.     being sent).  This override feature is for security purposes in
  1148.     the event that your database contains sensitive information that
  1149.     you do not want to be given out without your explicit consent.
  1150.  
  1151.  
  1152. ┌────────────────────────────────────────────────────────────────────┐
  1153. │                     2.1.3 ■ HELP ON THE MENUS                      │
  1154. └────────────────────────────────────────────────────────────────────┘
  1155.  
  1156. Selecting the "Pull-Down Menu Help" option from the PROJECT menu
  1157. allows you to view help information on the various menu options.  A
  1158. window will appear instructing you to select a pull-down menu option
  1159. for help.  Simply click on the right mouse button and pull down the
  1160. desired menu.  Select an option, and a Help Screen will appear on
  1161. that item.  When finished, press the <ESC> key to exit "Menu Help"
  1162. mode.  You may also select menu options via the keyboard by using the
  1163. F10 key to activate the menu system.
  1164.  
  1165.  
  1166. ┌────────────────────────────────────────────────────────────────────┐
  1167. │                  2.1.4 ■ MODEM SETUP INFORMATION                   │
  1168. └────────────────────────────────────────────────────────────────────┘
  1169.  
  1170. When you choose the Modem Options feature, a dialog box appears to
  1171. edit many of the available modem settings that are a part of
  1172. RIPterm.  The dialog box looks similar to the following:
  1173.  
  1174. ╔════════════════════════════════════════════════════════════════════╗
  1175. ║                            Modem Options                           ║
  1176. ║              ┌─────────────────────────────────────────────────┐   ║
  1177. ║   Modem Init │ AT &C1 &D2 E1 V1 X4^M                           │   ║
  1178. ║              ├─────────────────────────────────────────────────┤   ║
  1179. ║  Auto Answer │ AT S0=1^M                                       │   ║
  1180. ║              ├─────────────────────────────────────────────────┤   ║
  1181. ║  Modem Reset │ AT Z^M                                          │   ║
  1182. ║              ├────┬────────────────────────────────────────────┘   ║
  1183. ║  Redial Time │ 45 │  ┌───────────┐  ┌───────────┐  ┌───────────┐   ║
  1184. ║              └────┘  │ Comm Port │  │ Stop Bits │  │ Baud Rate │   ║
  1185. ║                      ├───────────┤  ├───────────┤  ├───────────┤   ║
  1186. ║                      │   COM1  X │  │  1 bit  X │  │     300 ■ │   ║
  1187. ║      RTS/CTS  ■      │   COM2  ■ │  │  2 bits ■ │  │    1200 ■ │   ║
  1188. ║    Baud Lock  ■      │   COM3  ■ │  └───────────┘  │    2400 X │   ║
  1189. ║    Use Modem  ■      │   COM4  ■ │                 │    4800 ■ │   ║
  1190. ║    Add CR/LF  ■      └───────────┘  ┌───────────┐  │    9600 ■ │   ║
  1191. ║                      ┌───────────┐  │   Parity  │  │  19,200 ■ │   ║
  1192. ║  ┌────────────┐      │ Data Bits │  ├───────────┤  │  38,400 ■ │   ║
  1193. ║  │     OK     │      ├───────────┤  │   None  X │  │  57,600 ■ │   ║
  1194. ║  ├────────────┤      │  8 bits X │  │    Odd  ■ │  │ 115,200 ■ │   ║
  1195. ║  │   CANCEL   │      │  7 bits ■ │  │   Even  ■ │  └───────────┘   ║
  1196. ║  └────────────┘      └───────────┘  └───────────┘                  ║
  1197. ╚════════════════════════════════════════════════════════════════════╝
  1198.  
  1199. This dialog box is for modifying your modem configuration.  You may
  1200. alter the modem initialization commands, the auto-answer string and
  1201. the modem reset command string.  These options use standard
  1202. Hayes-compatible modem commands.  If you wish to insert a "pause"
  1203. into the command, simply insert a comma (,).
  1204.  
  1205. In addition to modem commands, you may set the COM port, data bits,
  1206. stop bits, parity, and baud rate.  Standard settings are 8 data bits,
  1207. 1 stop bit and NO parity (8N1), or 7 data bits, 1 stop bit and EVEN
  1208. parity (7E1).  Additional options allow you to specify touch tone or
  1209. rotary (pulse) dialing, the number of seconds to wait for a
  1210. connection (redial time), whether to add CR/LF, and whether RIPterm
  1211. is connected directly to a modem or not.
  1212.  
  1213. To alter the serial port IRQ settings, choose the interrupt setup
  1214. option from the modem menu.
  1215.  
  1216. These settings are part of the setup, so once you alter them, you
  1217. should choose the SAVE SETUP option from the Modem menu.
  1218.  
  1219.  
  1220. ┌────────────────────────────────────────────────────────────────────┐
  1221. │                  2.1.4.1 ■ MODEM COMMAND STRINGS                   │
  1222. └────────────────────────────────────────────────────────────────────┘
  1223.  
  1224. Modem command strings are how you configure RIPterm to work with the
  1225. wide variety of modem on the market.  All modem commands begin with
  1226. an "AT", short for 'ATtention'.
  1227.  
  1228. You may specify control characters in a modem command string by
  1229. preceding the character with a caret (^).  For example, a CTRL-C
  1230. would be ^C.
  1231.  
  1232. Each modem command string should end with a ^M (carriage return), as
  1233. shown in the Modem Options dialog box above.
  1234.  
  1235. For more information on modem commands, consult your modem's manual.
  1236.  
  1237. ┌───────────────────┐
  1238. │ MODEM INIT STRING │
  1239. └───────────────────┘
  1240.  
  1241. This field is the modem command that is sent to the modem when
  1242. RIPterm starts up.  All modem commands begin with an "AT", short for
  1243. 'ATtention'.
  1244.  
  1245. ┌──────────────────────────┐
  1246. │ MODEM AUTO-ANSWER STRING │
  1247. └──────────────────────────┘
  1248.  
  1249. This modem command is what would be sent to the modem to set it for
  1250. "auto-answer" mode.  Auto-answer means that the modem will answer the
  1251. phone automatically when it rings.
  1252.  
  1253. ┌────────────────────┐
  1254. │ MODEM RESET STRING │
  1255. └────────────────────┘
  1256.  
  1257. This is the modem command string that is sent when the modem needs to
  1258. be reset.  This may be necessary if you "hang-up" the modem, abort a
  1259. dial attempt, or exit RIPterm.  For most modems, this command is Z,
  1260. which would be entered as "ATZ^m".
  1261.  
  1262.  
  1263.  
  1264. ┌────────────────────────────────────────────────────────────────────┐
  1265. │               1.1.5 ■ DIALING PREFIXES AND SUFFIXES                │
  1266. └────────────────────────────────────────────────────────────────────┘
  1267.  
  1268.     Dialing prefixes affect the way your modem dials telephone numbers.
  1269.     Prefixes and Suffixes when used allow you to dial some numbers
  1270.     a certain way and other numbers in a totally different manner.
  1271.  
  1272.     In order for your modem to dial a phone number, it must be
  1273.     issued a particular command.  Under most circumstances this
  1274.     command is the same for every number you dial in your dialing
  1275.     directory.  This can change though if you have different types
  1276.     of systems you call.  For example, on some BBS'es you might have
  1277.     to disable error correction on your modem to connect.  You
  1278.     wouldn't want to put the modem AT commands into your telephone
  1279.     number to accomplish this because it just won't work.  To better
  1280.     illustrate how Prefixes and Suffixes are related to dialing,
  1281.     consult the following:
  1282.  
  1283.           <Prefix>    <Phone Number>    <Suffix>
  1284.             ATDT        555-1212           ^M
  1285.     
  1286.     The normal Prefix is "ATDT".  This standards for (AT)tention
  1287.     (D)ial (T)ouch-tone.  If you were dialing out on a rotary phone
  1288.     line, that would be (P)ulse dialing (i.e., "ATDP").  This would
  1289.     be a typical use for a dialing prefix.  Also, if you had say
  1290.     several modems connected to your machine and you dialed out on
  1291.     different ones for different services, you could have one prefix
  1292.     setup that dialed a "9" to get an outside number, and a different
  1293.     setting for a "direct outside line".  Prefixes would be "ATDT 9,"
  1294.     and "ATDT" respectively.  
  1295.  
  1296.     Another use for Dialing Prefixes are for phone number passwords.
  1297.     If you work for a company that requires you to enter a password
  1298.     in order to dial-out, you could accomplish this as follows, 
  1299.     "ATDT 1234567~".  The 1234567 is your password and the tilde (~) is
  1300.     used for a 1/2 second pause.  After the pause the remainder of the
  1301.     phone number in the dialing directory will be dialed followed by
  1302.     the Dialing Suffix.
  1303.  
  1304.     If you choose a Prefix setting of "Default", then whichever of the
  1305.     three Prefix definitions you have tagged as "Default" will be
  1306.     used.  You may also explicity set a Prefix of 1, 2 or 3 to select
  1307.     a particular Prefix.  The idea behind the Default option is evident
  1308.     if you have your entire directory set to "default", then you take
  1309.     your computer somewhere where you need to dial say, "9" to get an
  1310.     outside line and you need to change your entire configuration
  1311.     quickly.
  1312.  
  1313.     A Dialing Suffix is the last thing that is transmitted to the modem
  1314.     when dialing a phone number.  The first thing transmitted is the
  1315.     dialing Prefix, followed by the phone number, then the suffix.
  1316.     Typically, the suffix is only a carriage return (^M).  However,
  1317.     you could get fancy with it and put other things before the
  1318.     carriage return like a phone number password (if it has to be
  1319.     entered "after" the phone number".  This would be useful if you
  1320.     wanted to apply this to all dialing directory entries simultaneously.
  1321.  
  1322.     In the Dial Prefix Editor, you may enter three separate Prefixes
  1323.     (1-3), and three different Suffixes (A-C).  Out of the three
  1324.     Prefixes you may select one of them to be considered the "Default"
  1325.     dialing Prefix by clicking inside the radio button next to the
  1326.     desired choice.  To indicate which Suffix is to be the default,
  1327.     follow the same procedure for the Suffix choices.  For non-mouse
  1328.     users, you can editor Prefix 1-3 by hitting ALT-1 through ALT-3.
  1329.     To activate the default button settings for Prefixes, just type
  1330.     the number 1-3 without the ALT key.  The same applies to manually
  1331.     editing Suffixes except that suffixes are A-C so it would be ALT-A
  1332.     through ALT-C, or A, B or C.
  1333.  
  1334.  
  1335. ┌────────────────────────────────────────────────────────────────────┐
  1336. │                    2.2 ■ THE DIALING DIRECTORY                     │
  1337. └────────────────────────────────────────────────────────────────────┘
  1338.  
  1339. When you choose the "Dialing Directory" option, a dialog box similar
  1340. to the following will appear:
  1341.  
  1342. ╔═══════════════════════════════════════════════════════════════════╗
  1343. ║                   Dialing Directory: RIPTERM.PHO                  ║
  1344. ╟───────────────────────────────────────────────────────────────────╢
  1345. ║ ┌─────────────────────────────────────────────────────────────┬─┐ ║
  1346. ║ │  1.  ArenaBBS            1-714-840-3520     2400  8N1  COM1 ││ ║
  1347. ║ │  2.  RIP Demo Midwest    1-708-978-2777    19200  8N1  COM2 ├─┤ ║
  1348. ║ │  3.  Nova Central        1-714-840-8641     9600  8N1  COM1 ││ ║
  1349. ║ │  4.  Galacticomm BBS     1-305-583-7808     9600  8N1  COM1 ││ ║
  1350. ║ │  5.  deltaComm BBS       1-919-481-9399    19200  8N1  COM1 ├─┤ ║
  1351. ║ │  6.  Searchlight BBS     1-516-689-2566    19200  8N1  COM1 ├─┤ ║
  1352. ║ │  7.  Synchronet BBS      1-714-529-9547    19200  8N1  COM1 ││ ║
  1353. ║ │  8.  Wildcat BBS         1-805-395-0650     9600  8N1  COM1 ││ ║
  1354. ║ │  9.  PC Board BBS        1-801-261-8976    19200  8N1  COM1 ├─┤ ║
  1355. ║ │ 10.  E-Soft (TBBS)       1-303-699-8222     9600  8N1  COM1 ││ ║
  1356. ║ └─────────────────────────────────────────────────────────────┴─┘ ║
  1357. ║      ┌────────┬────────┬────────┬────────┬────────┬────────┐      ║
  1358. ║      │  Edit  │  Mark  │ Unmark │ SaveAs │  Load  │  Find  │      ║
  1359. ║      ├────────┼────────┼────────┼────────┼────────┼────────┤      ║
  1360. ║      │  Dial  │ Cancel │  Kill  │  Print │ Toggle │  Help  │      ║
  1361. ║      └────────┴────────┴────────┴────────┴────────┴────────┘      ║
  1362. ╚═══════════════════════════════════════════════════════════════════╝
  1363.  
  1364. At the top of the dialing directory dialog box, the filename of the
  1365. dialing directory is displayed (e.g., "RIPTERM.PHO").  Whenever you
  1366. change dialing directory files, this will change to reflect the
  1367. current file in use.
  1368.  
  1369. In the middle of the dialog box is a listing of available hosts to
  1370. choose from.  Ten hosts are displayed at any once, and each directory
  1371. can contain up to 100 entries.  You can scroll through the available
  1372. hosts quickly by using the UP/DOWN arrows on the right of the
  1373. display.  Just underneath the UP arrow, and above the DOWN arrow are
  1374. two different buttons; these are used for PGUP, and PGDN.  The UP
  1375. ARROW, DOWN ARROW, PGUP, PGDN, HOME, and END keys work intuitively.
  1376.  
  1377. Any one of the ten lines in the window can be highlighted by pressing
  1378. ALT-1 through ALT-0 (10).  Any previously highlighted entries will be
  1379. un-highlighted and the given line in the window will be highlighted.
  1380. If you simultaneously hold down the SHIFT key while pressing ALT-1
  1381. through ALT-0, then the associated line will be highlighted in
  1382. addition to any previously highlighted lines (highlight merge).  Do
  1383. not confuse ALT-1 through ALT-0 with the numbers listed on the left
  1384. side of the window.  The numbers in the window are the entries in the
  1385. entire directory, not the window line number.  Pressing an ALT-1
  1386. through ALT-0 will highlight the window line number.  To highlight a
  1387. specific directory entry, see the MARK mode below.
  1388.  
  1389. Each host displays an entry number, the host name, telephone number,
  1390. baud rate, data bits (7 or 8), parity (E, N, O), stop bits (1 or 2),
  1391. and the COM port (COM1 - COM4).
  1392.  
  1393. There are twelve buttons at the bottom of the dialog box to choose
  1394. from.  They function as follows:
  1395.  
  1396.     ┌──────┐
  1397.     │ EDIT │
  1398.     └──────┘
  1399.  
  1400.     Clicking this button edits one or more dialing directory
  1401.     entries.  At least one entry must be highlighted (marked).  When
  1402.     clicked, a dialog box will appear for each host highlighted
  1403.     allowing you to edit each host's characteristics.  See the next
  1404.     section (2.2.1) for details on the Dialing Directory Editor.
  1405.  
  1406.     ┌──────┐
  1407.     │ DIAL │
  1408.     └──────┘
  1409.  
  1410.     Selecting DIAL calls one or more selected directory entries.  If
  1411.     more than one entry is highlighted, they will be dialed in
  1412.     numerical order.  If a connection is established to any host, it
  1413.     will be un-highlighted in the dialing directory so that later
  1414.     re-entry into the directory will allow you to dial the remaining
  1415.     hosts.  This option is automatically highlighted as the "default
  1416.     option" if at least one directory entries is highlighted.
  1417.  
  1418.     ┌──────┐
  1419.     │ MARK │
  1420.     └──────┘
  1421.  
  1422.     This option will mark (highlight) one or more dialing directory
  1423.     entries for subsequent action.  When chosen, a dialog box will
  1424.     appear allowing you enter information.  In this dialog box, you
  1425.     can enter one or more numbers indicating which directory entry(s)
  1426.     to highlight.  There are a number of options you may choose from
  1427.     for highlighting entries.  Some examples are:
  1428.  
  1429.         Examples:
  1430.         ---------
  1431.             1            ... highlight entry 1
  1432.             1, 2, 3      ... highlight entries 1, 2 and 3
  1433.             1 2 3        ... highlight entries 1, 2 and 3
  1434.             1;2;3        ... highlight entries 1, 2 and 3
  1435.             1-10         ... highlight entries 1 through 10
  1436.             15-          ... highlight entries 15 to the end (100)
  1437.             -5           ... highlight from Start (1) to entry 5
  1438.             -            ... highlight ALL entries
  1439.             1-5, 10, 95- ... highlight 1-5, 10 and 95-100
  1440.  
  1441.     In addition, you can also specify a "Mark Merge".  This mode
  1442.     allows you to combine your Marked entries with any entries that
  1443.     are already marked.  To use Mark Merge mode, enter a plus sign
  1444.     (+) as the first character.  For example, if entries 3 and 5 are
  1445.     highlighted, and you mark "+ 10-15", then entries 3, 5, and 10-15
  1446.     will be highlighted.
  1447.  
  1448.     One final option is the Mark Exclude mode.  This mode is similar
  1449.     to Mark Merge, except that all entries EXCEPT those highlighted
  1450.     are marked.  In other words, anything that you would think would
  1451.     be highlighted, would not be, and anything that shouldn't be
  1452.     highlighted, will be!  This odd way of doing things can become
  1453.     very handy when combined with some of the other options in the
  1454.     dialing directory.  To choose Mark Exclude mode, specify an
  1455.     exclamation mark (!) as the first character.
  1456.  
  1457.     You can combine Mark Merge, and Mark Exclude modes together.  To
  1458.     do this, enter the sequence "+!" as the first two characters in
  1459.     the dialog box.
  1460.  
  1461.     Mark Mode will be automatically be chosen if you begin typing
  1462.     something that appears to be a mark sequence.  In other words,
  1463.     you do not have to select Mark mode in order to Mark entries. For
  1464.     example, from the dialing directory dialog box, simply typing "1"
  1465.     will bring up the Mark dialog and place "1" in the editing field
  1466.     automatically and allow you to continue typing in your Mark
  1467.     expression.
  1468.  
  1469.     ┌────────┐
  1470.     │ CANCEL │
  1471.     └────────┘
  1472.  
  1473.     This will abort the dialing directory window.  Any previously
  1474.     highlighted entries will remain highlighted the next time you
  1475.     enter the directory.  You are returned to the terminal screen.
  1476.  
  1477.     ┌────────┐
  1478.     │ UNMARK │
  1479.     └────────┘
  1480.  
  1481.     This will un-highlight any previously highlighted directory
  1482.     entries.  You may also press the Space Bar to choose this option.
  1483.  
  1484.     ┌──────┐
  1485.     │ KILL │
  1486.     └──────┘
  1487.  
  1488.     This option will delete all previously highlighted directory
  1489.     entries.  You will be prompted to make absolutely sure that you
  1490.     truly wish to erase the entries.  All calling statistics for
  1491.     those entries will be erased as well.  Once an option is killed,
  1492.     it is permanently deleted.  If no entries are highlighted, this
  1493.     option has no affect.
  1494.  
  1495.     ┌─────────┐
  1496.     │ SAVE AS │
  1497.     └─────────┘
  1498.  
  1499.     This option will save either the entire dialing directory, or
  1500.     just the highlighted entries to another directory file.  This
  1501.     allows you to create new directory files quickly and easily for
  1502.     specific purposes. If one or more entries are highlighted, only
  1503.     those entries are copied to the new file.  If no entries are
  1504.     highlighted, then the entire dialing directory file is copied.
  1505.     You will be prompted to enter the destination filename.
  1506.  
  1507.     If the destination file exists, it is checked to see if it is a
  1508.     RIPterm dialing directory file.  If it is, you will be prompted
  1509.     to either merge the highlighted entries into destination file, or
  1510.     to overwrite the file with just the highlighted entries.
  1511.  
  1512.     In the event that the destination file becomes full, a message to
  1513.     the effect will be displayed informing you how many entries
  1514.     couldn't be copied.
  1515.  
  1516.     This "directory merge" feature is unique to RIPterm.
  1517.  
  1518.     NOTE: Modifications to the dialing directory are automatically
  1519.           saved to the current directory file.  You do not need to
  1520.           choose SAVE AS every time you add or edit an entry.
  1521.  
  1522.     ┌───────┐
  1523.     │ PRINT │
  1524.     └───────┘
  1525.  
  1526.     This prints the contents of the dialing directory (or highlighted
  1527.     entries) to either a disk file, or to a printer attached to LPT1.
  1528.     Choosing the disk option will prompt you for a filename.
  1529.  
  1530.     Before printing/saving occurs, you will be asked what type of
  1531.     output you wish.  You have two choices: TABLE format, or DETAILED
  1532.     BREAKDOWN.  Table format will print one entry per line, formatted
  1533.     for an 80-column display.
  1534.  
  1535.     System Name          System Phone Number
  1536.     ===========================================  continued next line
  1537.     ArenaBBS (TeleGrafix 1-714-840-3520
  1538.  
  1539.                                 Baud COM COM       Last  Mod
  1540.                                 Rate Vals # Calls  Call   ? Direc.
  1541.     continued from previous     ====================================
  1542.                                 2400  8N1 1   39  1/30/93 Y ARENA
  1543.  
  1544.     Specifying detailed mode will output a multi-line record for each
  1545.     entry. The format of detailed breakdown mode is similar to the
  1546.     following:
  1547.  
  1548.           Host Name: ArenaBBS (TeleGrafix)
  1549.         Telephone #: 1-714-840-3520
  1550.           Baud Rate: 2400
  1551.           Data Bits: 8
  1552.              Parity: NONE
  1553.           Stop Bits: 1
  1554.            COM Port: 1
  1555.           Directory: ARENA
  1556.         Connections: 39
  1557.           Last Call: 01/30/93
  1558.  
  1559.     ┌──────┐
  1560.     │ LOAD │
  1561.     └──────┘
  1562.  
  1563.     This option allows you to load up another dialing directory file.
  1564.     The current directory file will be closed and the specified file
  1565.     will be loaded in its place.  All entries are un-highlighted, and
  1566.     the window is automatically redisplays the newly loaded entries.
  1567.  
  1568.     ┌────────┐
  1569.     │ TOGGLE │
  1570.     └────────┘
  1571.  
  1572.     This option alters what information is displayed in the dialing
  1573.     directory window.  By default, the following information is
  1574.     displayed on each line in the window:
  1575.  
  1576.         Entry #
  1577.         Host Name
  1578.         Phone Number
  1579.         Baud Rate
  1580.         Data Bits, Parity and Stop Bits (e.g., 8N1)
  1581.         Communications Port (e.g., COM1)
  1582.  
  1583.     When you choose the toggle option, the information displayed will
  1584.     be changed to the following:
  1585.  
  1586.         Entry #
  1587.         Host Name
  1588.         Total # of calls
  1589.         Last call date
  1590.         Directory ID (see below)
  1591.         Modem or Serial-Port connection
  1592.  
  1593.     This is a simple toggle.  Each time you choose this option, the
  1594.     information displayed will change to the opposite mode.
  1595.  
  1596.     Your favorite toggle setting can be saved to your permanent
  1597.     RIPterm setup.  To do this, choose the toggle mode you like the
  1598.     best, exit the dialing directory, then choose Save Setup.
  1599.  
  1600.     ┌──────┐
  1601.     │ FIND │
  1602.     └──────┘
  1603.  
  1604.     This option will highlight zero or more entries that contain the
  1605.     specified search text.  Once you choose this option, a dialog box
  1606.     will appear prompting you to enter a piece of text to search for
  1607.     throughout the dialing directory.  Any entries that contain the
  1608.     chosen text will automatically be highlighted.  Search is not
  1609.     case sensitive.  The host name, phone number and directory-ID
  1610.     fields are searched for the text.  Text can appear anywhere in
  1611.     any of these three fields and will still be found.
  1612.  
  1613.     You may choose Find Merge mode, or Find Exclude mode (or both)
  1614.     exactly the same way as you can with the Mark mode.  The command
  1615.     characters (+ and !) are not added to the search string, and must
  1616.     be the first characters specified in the search string.  Merge
  1617.     mode can be quite useful if you wish to highlight all entries in
  1618.     a specific area code, or that contain a common theme (like
  1619.     "business", or "daily").
  1620.  
  1621.     ┌──────┐
  1622.     │ HELP │
  1623.     └──────┘
  1624.  
  1625.     This option displays the help screen for the dialing directory.
  1626.  
  1627.  
  1628. ┌────────────────────────────────────────────────────────────────────┐
  1629. │             2.2.1 ■ EDITING DIALING DIRECTORY ENTRIES              │
  1630. └────────────────────────────────────────────────────────────────────┘
  1631.  
  1632.     When you choose to edit one or more dialing directory entries, a
  1633.     dialog box similar to the following will appear on your screen
  1634.     allowing you to edit the various entries:
  1635.  
  1636. ╔════════════════════════════════════════════════════════════════════╗
  1637. ║                         Phone Entry Editor                         ║
  1638. ╟────────────────────────────────────────────────────────────────────╢
  1639. ║        ┌─────────────────────────┐                ┌──────────────┐ ║
  1640. ║   Name │Host name goes here...   │       Com Port │ 1           │ ║
  1641. ║        ├─────────────────────────┤                ├──────────────┤ ║
  1642. ║ Number │1-714-555-1212           │      Baud Rate │ 9600        │ ║
  1643. ║        ├────────────┬────────────┘  ┌─┐           ├──────────────┤ ║
  1644. ║    DIR │Directory   │         Modem │X│ Data Bits │ 8           │ ║
  1645. ║        └────────────┘  ┌───────────┐└─┘           ├──────────────┤ ║
  1646. ║ ┌──────┬──────┐ Prefix │ Default  │       Parity │ None        │ ║
  1647. ║ │ QUIT │ HELP │        ├───────────┤              ├──────────────┤ ║
  1648. ║ ├──────┴──────┤ Suffix │ 1        │    Stop Bits │ 1           │ ║
  1649. ║ │     OK!     │        └───────────┘              └──────────────┘ ║
  1650. ║ └─────────────┘                                                    ║
  1651. ╚════════════════════════════════════════════════════════════════════╝
  1652.  
  1653.     The significance of each of these fields are described below:
  1654.  
  1655.     ┌──────┐
  1656.     │ NAME │
  1657.     └──────┘
  1658.  
  1659.     The name field is the name of the host that will appear in the
  1660.     dialing directory window.  This is the name that will be
  1661.     displayed to you whenever you dial the host, and is used in
  1662.     general to describe the host.  You are allowed 25 characters
  1663.     for the host name.
  1664.  
  1665.     ┌────────┐
  1666.     │ NUMBER │
  1667.     └────────┘
  1668.  
  1669.     This is the telephone number (if any) that is used to dial the
  1670.     host.  You are allowed up to 25 characters for the number.  Valid
  1671.     characters are digits 0-9, hyphens and parenthesis (if your modem
  1672.     permits it).  You may also enter a comma (,) to indicate a
  1673.     half-second pause.  This pause is handled by your modem, not by
  1674.     RIPterm.  On some modems, this pause may be two or three seconds.
  1675.     Check your modem's documentation to determine the delay value.
  1676.  
  1677.     Some examples of Telephone Numbers are as follows:
  1678.  
  1679.                555-1212 ... Dial 555-1212
  1680.          1-714-555-1212 ... Dial (714) 555-1212
  1681.              9,555-1212 ... Dial a 9, then pause, then 555-1212
  1682.  
  1683.     ┌─────┐
  1684.     │ DIR │
  1685.     └─────┘
  1686.  
  1687.     This field takes a bit more explaining than the other fields in
  1688.     the directory editor.  Each entry in the directory has the
  1689.     ability to have a separate sub-directory associated with it.
  1690.     This is used mainly when RIPscrip graphics are being viewed on
  1691.     the host. Any icon (.ICN, .MSK, .HIC) or RIPscrip (.RIP) files
  1692.     that are received by the host should be placed in the designated
  1693.     sub-directory.  This in effect, helps keep your icons separated
  1694.     from each other.
  1695.  
  1696.     If you omit a directory name in this field, and you dial into a
  1697.     RIPscrip host that requires icons or RIPscrip files, RIPterm will
  1698.     look for them automatically in the ICONS\ sub-directory.  It is
  1699.     recommended that you keep host specific files in their proper
  1700.     sub-directories for elegant file maintenance.
  1701.  
  1702.     You do not need to create the sub-directory yourself.  The first
  1703.     time that you call into that host via the dialing directory,
  1704.     RIPterm will check the ID field, and if it is non-blank, will
  1705.     automatically create the sub-directory if it doesn't exist.
  1706.  
  1707.     If the ID field is non-blank, indicating a sub-directory should
  1708.     be used for that specific host, RIPterm will check in that
  1709.     directory first for any necessary icons or RIPscrip files.  If
  1710.     the needed file is not found in that sub-directory, RIPterm will
  1711.     check the ICONS\ sub-directory afterward to see if it is there.
  1712.     This facilitates the concept of "file override".
  1713.  
  1714.     This "file override" is best explained by an example.  Let's say
  1715.     you call several different RIPscrip hosts.  Each of them have
  1716.     numerous icons that they use for their host.  Now as you are
  1717.     probably aware, each sysop of each host thinks of his host as the
  1718.     only host in the world.  With that in mind, they would probably
  1719.     not give a great amount of thought to the names that they give
  1720.     their icon or RIPscrip files (i.e., not considering that other
  1721.     hosts might have files with the same names).  Files like
  1722.     EMAIL.ICN or FILES.ICN would be use on nearly any host!  If all
  1723.     these files were located in the same directory, only the very
  1724.     latest installed files would be used when you call a host!  In
  1725.     other words, when you call host XYZ, you might see host ABC's
  1726.     EMAIL icon! This is obviously not how it should work.  With this
  1727.     in mind, keeping files in separate sub-directories resolves this
  1728.     problem quite nicely.  Even if a sysop chooses to use the
  1729.     standard RIPterm EMAIL icon, he can do that too. All he has to do
  1730.     is NOT provide you with his own EMAIL icon.  RIPterm will find
  1731.     the correct file for you automatically.  It would first check
  1732.     host XYZ's directory (presumably directory "XYZ\"), and after
  1733.     finding that the file is not there, would check the ICONS\
  1734.     sub-directory and find it there.  In this fashion, the sysop has
  1735.     the ability to override standard icons with his own without
  1736.     affecting the standard icons in any way.
  1737.  
  1738.     Keep in mind, that if you dial a host by issuing modem commands
  1739.     directly (not using the dialing directory), then the correct
  1740.     directory may not be used since RIPterm has no way of knowing
  1741.     which dialing directory entry you are calling.  In other words,
  1742.     you should use the dialing directory to call ALL RIPscrip hosts!
  1743.  
  1744.     NOTE: RIPterm supports a "block protocol" mode for hosts that
  1745.           can support it.  This mode allows the host to send files to
  1746.           your computer for subsequent use.  Any files received in
  1747.           this mode are automatically placed in the proper host ID
  1748.           directory. If no host ID field is specified, then the
  1749.           ICONS\ sub-directory is chosen as the destination
  1750.           sub-directory.
  1751.  
  1752.     ┌───────┐
  1753.     │ MODEM │
  1754.     └───────┘
  1755.  
  1756.     This button is a toggle-type button.  It can be either ON or OFF.
  1757.     If it is enabled (the default), then when this entry is dialed,
  1758.     it will be assumed that it is calling the host via a modem
  1759.     device.  If it is off, then RIPterm will assume that the host is
  1760.     connected to your computer via a direct serial connection.
  1761.  
  1762.     If the modem option is activated, RIPterm will monitor the modem
  1763.     for a "CONNECT" message of some kind.  Other messages that can
  1764.     affect the dialing process are "ERROR", "NO DIALTONE", "VOICE" or
  1765.     "BUSY".
  1766.  
  1767.     If this option is inactive, typically, connection is made
  1768.     instantly, and you will be presented with some kind of an intro
  1769.     message.  RIPterm will automatically press <ENTER> to the host to
  1770.     try to activate the connection for you.
  1771.  
  1772.     ┌──────┐
  1773.     │ BAUD │
  1774.     └──────┘
  1775.  
  1776.     This option allows you to specify the baud rate at which the
  1777.     connection should be made (or at least attempted).  Valid baud
  1778.     rates are 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, and
  1779.     115200 baud.  If a CONNECT message is received indicating a baud
  1780.     rate other than the specified rate, RIPterm will automatically
  1781.     adjust the baud rate on its end to ensure that communication will
  1782.     take place (this is often called "auto-baud detect" mode).
  1783.  
  1784.     ┌──────┐
  1785.     │ PORT │
  1786.     └──────┘
  1787.  
  1788.     This option allows you to specify which communications port will
  1789.     be used to dial the given host.  Valid ports are COM1 through
  1790.     COM4.  Of course, your system must have the given port in order
  1791.     to be able to dial out on it.  Before the host is called, RIPterm
  1792.     will initialize the given port (if it hasn't already) and if
  1793.     everything is OK, will dial the host (or press <ENTER> if it's a
  1794.     non-modem host).
  1795.  
  1796.     ┌───────────┐
  1797.     │ STOP BITS │
  1798.     └───────────┘
  1799.  
  1800.     This option allows you to alter the number of "Stop Bits" that
  1801.     are used for the communications link.  Valid settings are 1 stop
  1802.     bit, or 2 stop bits.  Typically, 1 stop bit will be used for the
  1803.     vast majority of hosts.
  1804.  
  1805.     ┌────────┐
  1806.     │ PARITY │
  1807.     └────────┘
  1808.  
  1809.     This option allows you to alter the parity setting that will be
  1810.     used for a given communications link.  Valid settings are EVEN,
  1811.     ODD or NONE.  The vast majority of hosts in the world use a
  1812.     setting of NONE, for "No Parity".  Situations where you will
  1813.     choose something other than NONE would be if you were calling a
  1814.     mainframe computer, or dialing up via a nationwide network like
  1815.     TymNet, TeleNet, GEnie, CompuServe, or other such X.25-based
  1816.     hosts. If in doubt, try NONE.
  1817.  
  1818.     ┌───────────┐
  1819.     │ DATA BITS │
  1820.     └───────────┘
  1821.  
  1822.     This option allows you to alter the number of data bits that will
  1823.     be used for a given communications link.  Valid settings are 7
  1824.     data bits, or 8 data bits.  You will find that most hosts use 8
  1825.     data bits.  7 data bits are commonly used when calling mainframe
  1826.     computers, or large hosts like TymNet, TeleNet, GEnie,
  1827.     CompuServe, or other nationwide network services that use the
  1828.     X.25 network protocol.  When in doubt, try 8 data bits.  If you
  1829.     get garbled information, try 7.
  1830.  
  1831.     In the last three sub-sections, you've seen settings for data
  1832.     bits, parity, and stop bits.  In nearly 100% of every situation,
  1833.     there are only two combinations of these three values that are
  1834.     used. They are:
  1835.  
  1836.               8 data bits         7 data bits
  1837.                No parity          Even parity
  1838.               1 stop bit          1 stop bit
  1839.               -----------         -----------
  1840.                 8-N-1               7-E-1           <- referred to as
  1841.             eight-none-one      seven-even-one      <- pronounced
  1842.  
  1843.     ┌────────┐
  1844.     │ PREFIX │
  1845.     └────────┘
  1846.  
  1847.     This option lets you choose from one of several different ways to
  1848.     place a call with your modem.  In order for your modem to dial a
  1849.     phone number, it must be issued a particular command.  Under most
  1850.     circumstances this command is the same for every number you dial
  1851.     in your dialing directory.  This can change though if you have
  1852.     different types of systems you call.  For example, on some BBS'es
  1853.     you might have to disable error correction on your modem to connect.
  1854.     You wouldn't want to put the modem AT commands into your telephone
  1855.     number to accomplish this because it just won't work.  To better
  1856.     illustrate how Prefixes and Suffixes are related to dialing, consult
  1857.     the following:
  1858.  
  1859.           <Prefix>    <Phone Number>    <Suffix>
  1860.             ATDT        555-1212           ^M
  1861.     
  1862.     The normal Prefix is "ATDT".  This standards for (AT)tention
  1863.     (D)ial (T)ouch-tone.  If you were dialing out on a rotary phone
  1864.     line, that would be (P)ulse dialing (i.e., "ATDP").  This would
  1865.     be a typical use for a dialing prefix.  Also, if you had say
  1866.     several modems connected to your machine and you dialed out on
  1867.     different ones for different services, you could have one prefix
  1868.     setup that dialed a "9" to get an outside number, and a different
  1869.     setting for a "direct outside line".  Prefixes would be "ATDT 9,"
  1870.     and "ATDT" respectively.  
  1871.  
  1872.     Another use for Dialing Prefixes are for phone number passwords.
  1873.     If you work for a company that requires you to enter a password
  1874.     in order to dial-out, you could accomplish this as follows, 
  1875.     "ATDT 1234567~".  The 1234567 is your password and the tilde (~) is
  1876.     used for a 1/2 second pause.  After the pause the remainder of the
  1877.     phone number in the dialing directory will be dialed followed by
  1878.     the Dialing Suffix.
  1879.  
  1880.     If you choose a Prefix setting of "Default", then whichever of the
  1881.     three Prefix definitions you have tagged as "Default" will be
  1882.     used.  You may also explicity set a Prefix of 1, 2 or 3 to select
  1883.     a particular Prefix.  The idea behind the Default option is evident
  1884.     if you have your entire directory set to "default", then you take
  1885.     your computer somewhere where you need to dial say, "9" to get an
  1886.     outside line and you need to change your entire configuration
  1887.     quickly.
  1888.  
  1889.     ┌────────┐
  1890.     │ SUFFIX │
  1891.     └────────┘
  1892.  
  1893.     A Dialing Suffix is the last thing that is transmitted to the modem
  1894.     when dialing a phone number.  The first thing transmitted is the
  1895.     dialing Prefix, followed by the phone number, then the suffix.
  1896.     Typically, the suffix is only a carriage return (^M).  However,
  1897.     you could get fancy with it and put other things before the
  1898.     carriage return like a phone number password (if it has to be
  1899.     entered "after" the phone number".  This would be useful if you
  1900.     wanted to apply this to all dialing directory entries simultaneously.
  1901.  
  1902.     ┌────┐
  1903.     │ OK │
  1904.     └────┘
  1905.  
  1906.     This will accept any changes you have made and return you to the
  1907.     dialing directory dialog box.  Any changes you made in the editor
  1908.     will be reflected in the dialing directory window.  If you have
  1909.     highlighted multiple entries to edit, then the remaining entries
  1910.     (if any) that haven't been edited will be edited before you are
  1911.     returned to the dialing directory screen.
  1912.  
  1913.     ┌──────┐
  1914.     │ QUIT │
  1915.     └──────┘
  1916.  
  1917.     This will cancel any modifications you have made in the directory
  1918.     editor.  You will be returned to the dialing director
  1919.     automatically.  If you have chosen to edit multiple directory
  1920.     entries (by highlighting more than one), and there are entries
  1921.     that haven't been edited yet, they will be edited before you are
  1922.     eventually returned to the dialing directory.
  1923.  
  1924.     ┌──────┐
  1925.     │ HELP │
  1926.     └──────┘
  1927.  
  1928.     This option bring up the help screen for the directory editor.
  1929.  
  1930.  
  1931. ┌────────────────────────────────────────────────────────────────────┐
  1932. │    2.2.2 ■ DIALING DIRECTORY CONVERSION UTILITY (DIALCONV.EXE)     │
  1933. └────────────────────────────────────────────────────────────────────┘
  1934.  
  1935. For your convenience, a utility program has been included with
  1936. RIPterm to convert dialing directory files from other popular
  1937. terminal programs to RIPterm format.  This program currently supports
  1938. the conversion of Telix and TeleMate directory files to RIPterm
  1939. format.  Conversion is "one way".  In other words, you cannot convert
  1940. a RIPterm directory file to Telix format, but you can go the other
  1941. way around (Telix to RIPterm conversion).
  1942.  
  1943. Use of DIALCONV is quite simple.  The program will auto-detect what
  1944. type of dialing directory file is to be processed and will
  1945. automatically use the appropriate conversion method necessary for the
  1946. given file.
  1947.  
  1948. To convert a directory file, enter a command similar to:
  1949.  
  1950.     DIALCONV TELIX.FON RIPTERM.PHO
  1951.  
  1952. In the preceding example, DIALCONV would convert the Telix directory
  1953. file TELIX.FON to a RIPterm directory file called RIPTERM.PHO.
  1954. RIPterm uses the extension of .PHO to designate dialing directories.
  1955.  
  1956. All "statistical" data in the source directory file are converted
  1957. into the new RIPterm file.  For example, the last date a host was
  1958. called, and total number of calls you have made to that host are
  1959. converted as well and are made part of the RIPterm directory file. In
  1960. addition, COM port, baud rate and other settings are converted as
  1961. well for your convenience.
  1962.  
  1963. If you wish to simply view the contents of a Telix or TeleMate
  1964. directory file without conversion (to make sure that conversion would
  1965. take place properly), you can choose an optional "view" option for
  1966. DIALCONV by specifying the "-v" switch on the command line.  For
  1967. example, to list out all the valid entries in a Telix directory file
  1968. called TELIX.FON to the screen, enter the following command:
  1969.  
  1970.     DIALCONV -v TELIX.FON
  1971.  
  1972. All entries will be displayed to the screen for you.  Output can be
  1973. captured to a text file if you wish by using the MS-DOS redirection
  1974. feature.  Using the preceding example, let's say you wanted to print
  1975. all entries in the Telix directory file to the text file TELIX.LST,
  1976. enter the following command:
  1977.  
  1978.     DIALCONV -v TELIX.FON >TELIX.LST
  1979.  
  1980. Note the use of the redirection symbol ">" followed by the filename
  1981. to redirect output to.  You could just have easily directed the
  1982. programs output to the Printer with the following command:
  1983.  
  1984.     DIALCONV -v TELIX.FON >PRN
  1985.  
  1986.  
  1987. ┌────────────────────────────────────────────────────────────────────┐
  1988. │               2.2.3 ■ DIALING DIRECTORY FILE FORMAT                │
  1989. └────────────────────────────────────────────────────────────────────┘
  1990.  
  1991. For the technically minded, this section of this document defines the
  1992. internal structure of the RIPterm dialing directory file.  This is
  1993. provided for programmers who wish to create directory maintenance
  1994. utilities.
  1995.  
  1996. A RIPterm dialing directory file is a "flat-file" database with no
  1997. index.  Each record is of fixed length and is stored in numerical
  1998. order from 1-100.  Each entry is exactly 100 bytes in length, so a
  1999. dialing directory file is exactly 10,000 bytes in length.  Blank
  2000. entries are identified by the NAME, PHONE and HOST_ID fields being
  2001. entirely blank (i.e., NULL's).
  2002.  
  2003. The C data structure for each record is as follows:
  2004. ---------------------------------------------------
  2005.  
  2006.   struct phone_entry {
  2007.        char name[25];           /* Name of System             */
  2008.        char phone[25];          /* Phone Number of System     */
  2009.                                 /* -------------------------- */
  2010.        int  com_port;           /* COMx to use (0=default)    */
  2011.        long baud;               /* Baud Rate to dial at       */
  2012.        char data_bits;          /* Data Bits (7-8)            */
  2013.        char stop_bits;          /* Stop Bits (1-2)            */
  2014.        char parity;             /* Parity Setting             */
  2015.                                 /* -------------------------- */
  2016.        char system_id[13];      /* System-ID (resource filenm)*/
  2017.        long total_connects;     /* Total # of connections     */
  2018.        int  last_date;          /* Last Date connected        */
  2019.        int  reserved;           /* Reserved field             */
  2020.        char connected_to;       /* 0=modem, 1=computer        */
  2021.        char prefix;             /* Dialing Prefix (0=def, 1-3)*/
  2022.        char suffix;             /* Dialing Suffix (0=def, 1-3)*/
  2023.        char spare[17];          /* Spare space for upgrades   */
  2024.   };                            /* TOTAL SIZE: 100 bytes      */
  2025.  
  2026. The LAST_DATE field is an integer.  This variable uses the MS-DOS
  2027. method of encoding Dates into a 16-bit number.  Consult the MS-DOS
  2028. Programmer's Reference Manual for details on the internal format of
  2029. DOS Dates.
  2030.  
  2031.  
  2032. ┌────────────────────────────────────────────────────────────────────┐
  2033. │                      2.3 ■ DIALING THE MODEM                       │
  2034. └────────────────────────────────────────────────────────────────────┘
  2035.  
  2036. Press <ALT-M> to bring up the phone number dialog box.
  2037.  
  2038. Enter the telephone number you wish to dial.  You may enter any
  2039. numeric digits (0-9).  Hyphens are ignored.  Enter a comma for a 1/2
  2040. second delay (e.g., 9,1-714-555-1212).  You may need to add delays if
  2041. you have to use a special service or a switchboard to obtain an
  2042. outside line dial-tone.
  2043.  
  2044. The dialing window will appear when RIPterm is attempting to dial the
  2045. modem.  On this window will be displayed the number of seconds that
  2046. have elapsed, the time that dialing started, the time of the last
  2047. re-dial attempt, the telephone number and other information about the
  2048. dialing state.
  2049.  
  2050. Pressing <ENTER> will abort the current dialing attempt and start
  2051. over.  Pressing <ESC> or clicking "Cancel" will abort dialing.
  2052.  
  2053.  
  2054. ┌────────────────────────────────────────────────────────────────────┐
  2055. │                     2.4 ■ THE DIALING WINDOW                       │
  2056. └────────────────────────────────────────────────────────────────────┘
  2057.  
  2058. When RIPterm dials a host, it will display a dialog box showing you
  2059. the progress when dialing the host.  The dialog box looks similar to:
  2060.  
  2061. ╔═══════════════════════════════════════════════════════════════════╗
  2062. ║          ┌─────────────────────────────────┐                      ║
  2063. ║     Host │ Host name goes here...          │                      ║
  2064. ║          ├─────────────────────────────────┤           ┌─────┐    ║
  2065. ║  Phone # │ 1-714-555-1212                  │   Attempt │ 005 │    ║
  2066. ║          ├──────────┬───────────┬──────────┤           ├─────┼─┐  ║
  2067. ║  Started │ 08:23:25 │   Current │ 08:31:42 │    Remain │ 10  ││  ║
  2068. ║          ├──────────┴───────────┴──────────┴───────────┴─────┴─┤  ║
  2069. ║  Message │ Host is Busy.  Redialing...                         │  ║
  2070. ║          └─────────────────────────────────────────────────────┘  ║
  2071. ║      ╔════════════╗      ┌────────────┐      ┌────────────┐       ║
  2072. ║      ║   REDIAL   ║      │   CANCEL   │      │   DELETE   │       ║
  2073. ║      ╚════════════╝      └────────────┘      └────────────┘       ║
  2074. ╚═══════════════════════════════════════════════════════════════════╝
  2075.  
  2076. Each field is described more fully in the following sections:
  2077.  
  2078.     ┌──────┐
  2079.     │ HOST │
  2080.     └──────┘
  2081.  
  2082.     This field displays the name of the host that is being dialed.
  2083.     This field may be blank if you choose to dial via the manual
  2084.     dialing method (ALT-M).  If you are dialing by choosing entries
  2085.     from the dialing directory, whatever host name is displayed will
  2086.     be shown in this field when that entry is dialed.
  2087.  
  2088.     ┌─────────┐
  2089.     │ PHONE # │
  2090.     └─────────┘
  2091.  
  2092.     This displays the telephone number that is being used when
  2093.     dialing the designated host.  It is shown in this field exactly
  2094.     as it is transmitted to the modem.
  2095.  
  2096.     ┌─────────┐
  2097.     │ STARTED │
  2098.     └─────────┘
  2099.  
  2100.     This field shows the time that this dialing attempt began. The
  2101.     format of this field is HH:MM:SS.  Whenever a number is dialed,
  2102.     or the dialing window cycles to the next number, this field is
  2103.     updated with the current time that the telephone number is issued
  2104.     to the modem to dial out.
  2105.  
  2106.     ┌─────────┐
  2107.     │ CURRENT │
  2108.     └─────────┘
  2109.  
  2110.     This field displays the current time.  This field will constantly
  2111.     change as the dialing progresses.  It is intended to give you a
  2112.     visual reference to the time, compared to the start time.
  2113.  
  2114.     ┌─────────┐
  2115.     │ MESSAGE │
  2116.     └─────────┘
  2117.  
  2118.     Periodically through the dialing process, various status messages
  2119.     may need to be displayed to give you more information on what is
  2120.     going on.  Of the various messages, you might see things like,
  2121.     "Host is Busy.  Redialing...", or "Time elapsed without
  2122.     connection". This is generally used to tell you what is going on.
  2123.  
  2124.     ┌─────────┐
  2125.     │ ATTEMPT │
  2126.     └─────────┘
  2127.  
  2128.     This shows how many attempts have been tried thus far for this
  2129.     phone number.  If the host is busy, then it will try again after
  2130.     a brief pause.  If you have many hosts "queued" up to dial, then
  2131.     this shows the attempt number only for the given host being
  2132.     dialed at the moment.  Up to 999 attempts will be made before
  2133.     RIPterm stops all dialing attempts to a particular host.
  2134.  
  2135.     ┌────────┐
  2136.     │ REMAIN │
  2137.     └────────┘
  2138.  
  2139.     This message displays how many seconds remain before the current
  2140.     dialing attempt will terminate.  By default, redial time is set
  2141.     to 30 seconds, but this can be changed from within the modem
  2142.     options dialog box.  High speed modems, or long distance calls
  2143.     frequently need more than 30 seconds to complete an outgoing
  2144.     call. To the right of this field are two small arrows, an UP
  2145.     arrow, and a DOWN arrow.  These are for temporarily increasing or
  2146.     decreasing the redial time for the rest of this dialing attempt.
  2147.  
  2148.     ┌────────┐
  2149.     │ REDIAL │
  2150.     └────────┘
  2151.  
  2152.     This button will cause what's commonly known as a "cycle" to
  2153.     occur.  This is used when you have highlighted a number of
  2154.     entries to dial.  By clicking on redial, it will stop calling
  2155.     whichever host is currently being dialed, and will cycle to the
  2156.     next highlighted host in your dialing list and begin to dial that
  2157.     number.  If you are only dialing one host, this will stop the
  2158.     current dialing attempt and re-dial the same number again.
  2159.  
  2160.     ┌────────┐
  2161.     │ CANCEL │
  2162.     └────────┘
  2163.  
  2164.     This option will stop dialing.  You will be returned to the
  2165.     RIPterm session screen.  Any entries in the dialing directory
  2166.     that you were trying to dial will remain highlighted the next
  2167.     time you enter the dialing directory.
  2168.  
  2169.     ┌────────┐
  2170.     │ DELETE │
  2171.     └────────┘
  2172.  
  2173.     This option will remove an entry from your dial list.  What this
  2174.     means is that whatever host is currently being dialed will have
  2175.     its dialing attempt stopped, and then it will be un-highlighted
  2176.     in the dialing directory, then RIPterm will attempt to dial the
  2177.     next highlighted number (if any).  If no more entries are
  2178.     available in the dialing list, RIPterm will abort all dialing and
  2179.     return to the RIPterm session window.
  2180.  
  2181.  
  2182. ┌────────────────────────────────────────────────────────────────────┐
  2183. │                       2.5 ■ SCROLLBACK MODE                        │
  2184. └────────────────────────────────────────────────────────────────────┘
  2185.  
  2186. Scrollback mode allows you to review previously displayed text
  2187. information that has come across the modem.  You may set the
  2188. scrollback buffer size to 5k - 64k.
  2189.  
  2190. Within scrollback, you may choose from the following options:
  2191.  
  2192.     ■ SAVE buffer page to a text file
  2193.     ■ SAVE entire buffer to a text file
  2194.     ■ PRINT the current buffer page, or the entire buffer
  2195.     ■ SEARCH for a particular piece of text
  2196.     ■ SEARCH again for a previously searched for text string
  2197.  
  2198. At the top of the scrollback screen are a number of icons for the
  2199. above commands.  In addition, there are icons for scrolling up, down,
  2200. paging up and down or moving to the beginning or end of the buffer.
  2201.  
  2202. NOTE: The scrollback buffer filters out ANSI color codes and
  2203.       RIPscrip graphics for an uncluttered text display.
  2204.  
  2205. ┌─────────────────────────────┐
  2206. │ EDITING THE SCROLLBACK SIZE │
  2207. └─────────────────────────────┘
  2208.  
  2209. This option allows you to specify how much RAM RIPterm should use for
  2210. the scrollback buffer.  You may choose from 5k - 64k of RAM.
  2211. Depending on how much conventional memory you have on your computer,
  2212. this may limit the amount of memory you can allocate to scrollback.
  2213. We recommend that you set it to somewhere around 32k unless you know
  2214. that your PC has quite a bit of its 640k memory free for use.  If you
  2215. have many memory resident programs (TSR's) loaded, you may need to
  2216. drop the size of your scrollback buffer to a smaller value for proper
  2217. operation of RIPterm.
  2218.  
  2219. If RIPterm runs out of memory, it will begin to discard old
  2220. scrollback information until it can satisfy the memory request.
  2221.  
  2222.  
  2223. ┌────────────────────────────────────────────────────────────────────┐
  2224. │                        2.6 ■ THE STATUS BAR                        │
  2225. └────────────────────────────────────────────────────────────────────┘
  2226.  
  2227. At the bottom of the screen is the status bar (normally on).  This
  2228. gives you information about the current configuration of RIPterm.  It
  2229. also provides you with a quick and easy way to access several of the
  2230. basic features of RIPterm without having to use the menus.
  2231.  
  2232. You may toggle the status bar ON and OFF quickly by pressing
  2233. ALT-SPACE.  The host might turn the status bar ON or OFF for you,
  2234. using RIPscrip commands.  If it mysteriously vanishes for some
  2235. reason, keep in mind that the host you are connected to probably did
  2236. it because it needs the extra line for text!
  2237.  
  2238. There are a number of different "fields" in the Status Bar.  They are:
  2239.  
  2240.         ┌───────────┬─────────────┬──────────┬─────────────────┬
  2241.         │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
  2242.         └───────────┴─────────────┴──────────┴─────────────────┴
  2243.              (1)          (2)          (3)      (4)      (5)
  2244.  
  2245.         ┬──────┬──────────────────┬─────────┐
  2246.         │ COM1 │ RIPterm v1.51.00 │ Offline │
  2247.         ┴──────┴──────────────────┴─────────┘
  2248.           (6)           (7)           (8)
  2249.  
  2250.         (1) How to get the help system table of contents
  2251.  
  2252.         (2) How to use the keyboard only to select from the menus
  2253.  
  2254.         (3) What terminal emulation is in use, or the name of the log
  2255.             file if one has been opened
  2256.  
  2257.         (4) The baud rate, parity setting, data bits and stop bits
  2258.  
  2259.         (5) Full-duplex (FDX) or half-duplex (HDX)settings
  2260.  
  2261.         (6) The COM port that is currently in use
  2262.  
  2263.         (7) The current version number of RIPterm
  2264.  
  2265.         (8) Whether you are "on-line" or "off-line"
  2266.  
  2267. Each one of the fields just described can be clicked on (if the
  2268. status bar is on).  Once clicked, a different action is performed
  2269. based upon the current state of RIPterm, and what field you clicked
  2270. on.  Each of the various fields are described below:
  2271.  
  2272.     ┌────────────────────────┐
  2273.     │ HELP TABLE OF CONTENTS │
  2274.     └────────────────────────┘
  2275.  
  2276.     This option displays the Help Table of Contents.  From here, you
  2277.     can access any area in the Help System quickly and easily.
  2278.  
  2279.     ┌─────────────────────┐
  2280.     │ ACCESSING THE MENUS │
  2281.     └─────────────────────┘
  2282.  
  2283.     When you click on this option, the menu bar at the top of the
  2284.     screen will be highlighted for you.  You may then use the
  2285.     keyboard to navigate through the menus quickly and easily to
  2286.     choose options.
  2287.  
  2288.     ┌─────────────┐
  2289.     │ MISC. FIELD │
  2290.     └─────────────┘
  2291.  
  2292.     This field serves two purposes.  If you are current logging your
  2293.     session to a disk "log file", the filename (without extension) of
  2294.     the log file will be displayed in here.  In this mode, clicking
  2295.     in this field will close (or pause) the log file.  If you are not
  2296.     logging your session to disk, then this field will display the
  2297.     phrase "RIPscrip", indicating that you are using a RIPscrip
  2298.     compatible terminal program.  Clicking on this field in this mode
  2299.     will bring up a help screen telling you more about RIPscrip
  2300.     graphics in general.
  2301.  
  2302.     ┌─────────────────────────┐
  2303.     │ COMMUNICATIONS SETTINGS │
  2304.     └─────────────────────────┘
  2305.  
  2306.     This field indicates what the current communications parameters
  2307.     are.  The baud rate (300-115,200 baud) is displayed as well as
  2308.     the data bits (7 or 8), parity ( N = none, E = even and O = odd),
  2309.     and stop bits (1 or 2).  If local-echo is enabled, then the
  2310.     phrase "HDX" is displayed which means "Half Duplex".  If this is
  2311.     disabled (no echo), then the phrase "FDX" is displayed indicating
  2312.     "Full Duplex" mode is in effect.
  2313.  
  2314.     Clicking on this field brings up the Modem Settings dialog box.
  2315.  
  2316.     ┌─────────────────────┐
  2317.     │ COMMUNICATIONS PORT │
  2318.     └─────────────────────┘
  2319.  
  2320.     This field displays what communications port you are using.
  2321.     Clicking on this field brings up the modem settings dialog box.
  2322.  
  2323.     ┌─────────────────────┐
  2324.     │ RIPTERM INFORMATION │
  2325.     └─────────────────────┘
  2326.  
  2327.     This field displays the version number of RIPterm that you are
  2328.     using.  Clicking on it brings up a help screen corresponding to
  2329.     "About RIPterm" in the Project menu.  It displays information
  2330.     about the current version of RIPterm.
  2331.  
  2332.     ┌────────────────────────────┐
  2333.     │ ON-LINE/OFF-LINE INDICATOR │
  2334.     └────────────────────────────┘
  2335.  
  2336.     This field displays whether you are on-line or off-line. When
  2337.     RIPterm is starting up, you might see the phrase "Loading..." in
  2338.     this field; this is just a status indicator telling you RIPterm
  2339.     is doing something.  The purpose of this field is for you to be
  2340.     able to, at a glance, determine if you are still connected to a
  2341.     host or not.  This field is updated whenever your on-line status
  2342.     changes in any way (providing your modem is configured for
  2343.     carrier detect!).
  2344.  
  2345.     Clicking on this field will do one of two things depending on
  2346.     what the current on-line/off-line status is.  if you are on-line,
  2347.     clicking on this field will ask you if you wish to hang-up
  2348.     (providing you are using your modem to connect to a host).  If it
  2349.     says you are off-line, clicking on this field will bring up the
  2350.     dialing directory, thus allowing you to dial a host.
  2351.  
  2352.  
  2353. ┌────────────────────────────────────────────────────────────────────┐
  2354. │                       2.7 ■ STARTING RIPTERM                       │
  2355. └────────────────────────────────────────────────────────────────────┘
  2356.  
  2357. There are a number of options that you may choose from when starting
  2358. up RIPterm.  These options are specified as "parameters" on the DOS
  2359. command line.  Each option is preceded with either a hyphen (-) or a
  2360. forward slash (/).  Each option is described below:
  2361.  
  2362.     -N         ... Suppress the intro screen
  2363.     -M         ... Disables all mouse activity
  2364.     -O         ... Indicate you are already on-line (don't init modem)
  2365.     -E         ... Disable extended keyboard support
  2366.     -Z         ... Disable zooming windows
  2367.     -D<entry#> ... Dial <entry#> upon start up (from 1-100)
  2368.     -P<file>   ... Use an alternate phone directory file
  2369.     -R<file>   ... Play-back .RIP file upon start up
  2370.     -S<file>   ... Use an alternate setup file
  2371.  
  2372. Command line options are not case sensitive.  You may specify these
  2373. options together (for single character options), or as separate
  2374. parameters on the command line.  For example, to suppress the intro
  2375. screen, disable zooming windows and indicate that you are already
  2376. on-line, you could execute the following DOS command:
  2377.  
  2378.     RIPTERM -noz
  2379.  
  2380. Each of these options are described more fully in the following
  2381. sub-sections:
  2382.  
  2383.     ┌──────────────────────────────────┐
  2384.     │ -N ... Suppress the Intro Screen │
  2385.     └──────────────────────────────────┘
  2386.  
  2387.     When you choose this option, the start up logo screen is
  2388.     disabled.  You will be placed directly into RIPterm's session
  2389.     screen providing there are no configuration problems, or other
  2390.     questions that RIPterm must ask you in order to run properly.
  2391.  
  2392.     ┌────────────────────────────────────┐
  2393.     │ -M ... Disables all Mouse Activity │
  2394.     └────────────────────────────────────┘
  2395.  
  2396.     When you choose this option, RIPterm will not check for a mouse.
  2397.     In fact, regardless of whether or not a mouse is installed,
  2398.     RIPterm will not use it.  Generally speaking, you will probably
  2399.     never need to use this option unless you find that RIPterm
  2400.     doesn't operate properly with your mouse.
  2401.  
  2402.     ┌────────────────────────────────────────────────────────────┐
  2403.     │ -O ... Indicate you are already on-line (don't init modem) │
  2404.     └────────────────────────────────────────────────────────────┘
  2405.  
  2406.     When you choose this option, RIPterm will not initialize the
  2407.     modem for you (if your default mode is "modem connection" mode).
  2408.     If you are in this state, RIPterm will simply start up and press
  2409.     the <ENTER> key.  This is done to (ideally) display some kind of
  2410.     prompt on the host for you (or at least something). Note that
  2411.     RIPterm will auto-sense if you are already on-line and do this for
  2412.     you if it detects you're on-line.  This only applies to modem
  2413.     connection mode.
  2414.  
  2415.     If you are in non-modem connection mode and you specify this
  2416.     option, RIPterm will start up and do absolutely nothing.  It will
  2417.     not press the <ENTER> key for you.  It will simply enter the
  2418.     session screen and sit there waiting for you to do something.
  2419.  
  2420.     ┌──────────────────────────────────────────┐
  2421.     │ -E ... Disable extended keyboard support │
  2422.     └──────────────────────────────────────────┘
  2423.  
  2424.     This option is primarily for use when you are trying to
  2425.     troubleshoot the "doorway mode".  Doorway mode will take
  2426.     advantage of a 101-key enhanced AT computer keyboard.  If you
  2427.     enable 101-key keyboard mode, and you do not have a 101-key
  2428.     keyboard (or RIPterm doesn't think you have one), RIPterm might
  2429.     lock-up.  If you inadvertently saved this setup, the next time
  2430.     RIPterm starts up, it could freeze up on you when you enter
  2431.     doorway mode again.  In this case, use this start up option to
  2432.     "override" 101-key keyboard mode so that you can disable it and
  2433.     fix things for normal operation. This option should almost never
  2434.     be necessary except in troubleshooting situations.
  2435.  
  2436.     ┌────────────────────────────────┐
  2437.     │ -Z ... Disable Zooming Windows │
  2438.     └────────────────────────────────┘
  2439.  
  2440.     This option will disable the zooming windows feature of RIPterm
  2441.     for the duration of the current RIPterm session.  This mode
  2442.     overrides the setup option for zooming windows.  If you select
  2443.     Save Setup from the Modem menu, this override will become
  2444.     permanent (until changed and saved).  Some people find the
  2445.     zooming windows feature annoying in that it slows down operation
  2446.     of opening and closing windows a little bit.  For these power
  2447.     users, you may use this option, or simply save the zoom windows
  2448.     off setting to your setup.
  2449.  
  2450.     ┌─────────────────────────────────────────────────────────┐
  2451.     │ -D<entry#> ... Dial <entry#> upon start up (from 1-100) │
  2452.     └─────────────────────────────────────────────────────────┘
  2453.  
  2454.     This option will instruct RIPterm to automatically dial a
  2455.     particular entry in the dialing directory immediately after it
  2456.     initializes the Modem (if necessary).  Whether or not the
  2457.     connection can be established or not is unimportant, RIPterm will
  2458.     remain active regardless.  Use this option from within a batch
  2459.     file if you frequently start up RIPterm and need to dial a
  2460.     particular number. You may specify a dialing directory entry from
  2461.     1-100.  An example of using this option is as follows:
  2462.  
  2463.         RIPTERM -D15
  2464.  
  2465.     The above example starts up RIPterm, places a call to dialing
  2466.     directory entry #15 just as if you had selected it manually.
  2467.  
  2468.     ┌────────────────────────────────────────────────────┐
  2469.     │ -P<file> ... Use an alternate Phone Directory file │
  2470.     └────────────────────────────────────────────────────┘
  2471.  
  2472.     This option instructs RIPterm to load a dialing directory file
  2473.     other than RIPTERM.PHO upon start up.  This option is useful if
  2474.     you frequently use a special dialing directory file for certain
  2475.     applications.  This option can be used with the command line
  2476.     option to automatically dial a directory entry upon start up.  In
  2477.     other words, you can combine the -P and -D parameters together on
  2478.     the same command as in the following example:
  2479.  
  2480.                         RIPTERM -Pmyfile.pho -D3
  2481.  
  2482.     The above example would load RIPterm, load the directory file
  2483.     called MYFILE.PHO, initialize the modem, then automatically dial
  2484.     entry number 3 in the MYFILE.PHO dialing directory file.
  2485.  
  2486.     ┌────────────────────────────────────────────────┐
  2487.     │ -R<file> ... Play-back .RIP file upon start up │
  2488.     └────────────────────────────────────────────────┘
  2489.  
  2490.     This option allows you to execute a local .RIP file upon initial
  2491.     start up of RIPterm.  This allows you to draw some graphics, or
  2492.     even set up a screen with modem configuration mouse buttons.
  2493.     This allows for a great deal of flexibility.
  2494.  
  2495.     ┌──────────────────────────────────────────┐
  2496.     │ -S<file> ... Use an alternate setup file │
  2497.     └──────────────────────────────────────────┘
  2498.  
  2499.     This option allows you to specify an alternate RIPterm setup file
  2500.     upon start up.  By default, RIPterm will load RIPTERM.CNF (or
  2501.     create one if necessary).  Use this option if you frequently
  2502.     start up in a particular configuration (e.g., using a COM port
  2503.     other than the standard default port that is recorded in
  2504.     RIPTERM.CNF). This option may be combined with any other command
  2505.     line parameter for RIPterm as in the following example:
  2506.  
  2507.         RIPTERM -nz -Pmyfile.pho -Smysetup.cnf -D10
  2508.  
  2509.     The above example suppresses the intro logo screen, instructs
  2510.     RIPterm not to use zooming windows, loads the dialing directory
  2511.     file MYFILE.PHO, loads configuration file MYSETUP.CNF and
  2512.     automatically dials directory entry #10 upon start up.  This is
  2513.     about as complex of a start up example as you can get.  This is
  2514.     typically nothing like what you would ever use with RIPterm
  2515.     unless you are what is commonly referred to as a "Power User",
  2516.     whereby this stuff would be old hat to you anyway.
  2517.  
  2518.  
  2519. ┌────────────────────────────────────────────────────────────────────┐
  2520. │                         2.8 ■ MACRO EDITOR                         │
  2521. └────────────────────────────────────────────────────────────────────┘
  2522.  
  2523. Macros are functions that you can define to perform short-cut
  2524. operations on the host.  For example, you can instruct RIPterm to
  2525. make the F5 key type your user-id and press <ENTER> for you.  This
  2526. would allow you to log-on quickly by simply pressing a single key.
  2527. RIPterm's macro system is easy to use, and very powerful!  You can
  2528. save your macro keys to the default macro file (RIPTERM.KEY), or if
  2529. you need to have multiple macro configurations, you can save macros
  2530. to different files.
  2531.  
  2532. When you choose the macro editor option, a dialog box similar to the
  2533. following will be displayed:
  2534.  
  2535.    ╔══════════════════════════════════════════════════════════════╗
  2536.    ║                     RIPterm Macro Editor                     ║
  2537.    ║  ┌──────────────────────────────────────┬─┐  ┌────────────┐  ║
  2538.    ║  │  CTRL-F2: This is Macro #1 ......... ││  │    EDIT    │  ║
  2539.    ║  ├──────────────────────────────────────┼─┤  ├────────────┤  ║
  2540.    ║  │    ALT-G: This is Macro #2 ......... │ │  │   DELETE   │  ║
  2541.    ║  ├──────────────────────────────────────┤ │  ├────────────┤  ║
  2542.    ║  │       F2: This is Macro #3 ......... │ │  │    CLEAR   │  ║
  2543.    ║  ├──────────────────────────────────────┤ │  ├────────────┤  ║
  2544.    ║  │ SHIFT-F9: This is Macro #4 ......... │ │  │    SAVE    │  ║
  2545.    ║  ├──────────────────────────────────────┼─┤  ├────────────┤  ║
  2546.    ║  │ CTRL-F10: This is Macro #5 ......... ││  │    LOAD    │  ║
  2547.    ║  └──────────────────────────────────────┴─┘  └────────────┘  ║
  2548.    ║          ┌──────────────┐          ┌──────────────┐          ║
  2549.    ║          │      OK      │          │    CANCEL    │          ║
  2550.    ║          └──────────────┘          └──────────────┘          ║
  2551.    ╚══════════════════════════════════════════════════════════════╝
  2552.  
  2553. The currently defined macros are displayed in the scrolling window on
  2554. the left side of the dialog box.  On the right side, are buttons
  2555. which allow you to add/edit macros, delete existing macros, Clear all
  2556. macros, load a macro file and save all macros to a macro file.
  2557.  
  2558. When selecting macros to edit/delete, you may click on an existing
  2559. macro then click on EDIT or DELETE.  If you wish to edit/delete more
  2560. than one macro at the same time, click on each macro while holding
  2561. down the SHIFT key.  If you click on EDIT without any macros being
  2562. highlighted, you go into ADD macro mode.
  2563.  
  2564. You may store multiple macros into Macro .KEY Files for future use.
  2565. You may have as many macro files as you wish limited only by the
  2566. amount of available disk space.
  2567.  
  2568. ┌──────────────────────────────────────┐
  2569. │ ENTER KEYSTROKE FOR THE MACRO EDITOR │
  2570. └──────────────────────────────────────┘
  2571.  
  2572. Type the keystroke that you wish to record a macro for.  For example,
  2573. if you wanted to record a macro for the F5 key, simply press the F5
  2574. key.  You may specify CTRL, ALT or SHIFT keys as well.  RIPterm's
  2575. macro editor allows you to define literally hundreds of macros using
  2576. nearly as complex a keystroke as you want.  To exit the ADD mode,
  2577. simply press the <SPACE> key.  Beware that you probably would never
  2578. want to make CTRL-M (return), CTRL-H (backspace) or ALT-K (keystroke
  2579. macros) into macros themselves.  This would make it difficult to use
  2580. RIPterm with the keyboard.
  2581.  
  2582. ┌────────────────────────────────────────────┐
  2583. │ TEXT TO SEND HOST WHEN THIS KEY IS PRESSED │
  2584. └────────────────────────────────────────────┘
  2585.  
  2586. Enter the text that should be sent to the host (or the modem) if this
  2587. macro is entered.  In other words, enter the text that you want to be
  2588. associated with this macro.  For example, if you wanted to send the
  2589. text "Hello World" to the host when you press F5, simply type in
  2590. "Hello World".
  2591.  
  2592. You may enter control characters into your macros by using a caret
  2593. (^), followed by the letter of the control key you want to send.  For
  2594. example, a CTRL-C would be represented as ^C.  A carriage return
  2595. (<ENTER>) is specified as ^M.  Also, an ESCAPE is generated by the
  2596. sequence ^[ ... There are a number of different combinations of
  2597. CONTROL CHARACTERS that you may choose from (see SECTION 2.8.1 for
  2598. more details).
  2599.  
  2600. In addition to control characters, you can also insert TEXT VARIABLES
  2601. (SECTION 2.8.2) or POPUP LISTS (SECTION 2.8.3) into your macros.  See
  2602. the following sections of the manual for further information.
  2603.  
  2604. ┌──────────────────────────────┐
  2605. │ SAVING YOUR MACROS TO A FILE │
  2606. └──────────────────────────────┘
  2607.  
  2608. Enter the filename that you want to save your defined macros to.  By
  2609. default, the Macro File RIPTERM.KEY is prompted.  If you do not wish
  2610. to store your existing macros as the "Default RIPterm" macros, save
  2611. them to a different file.
  2612.  
  2613. ┌─────────────────────────────────┐
  2614. │ LOADING YOUR MACROS FROM A FILE │
  2615. └─────────────────────────────────┘
  2616.  
  2617. Enter the filename of the macro .KEY file you wish to load.  Macro
  2618. files are contained in the current RIPTERM directory unless otherwise
  2619. specified.  By default, RIPTERM.KEY is prompted, so that you can load
  2620. the default macros quickly and easily.  If you wish to load a custom,
  2621. non-default macro file, simply backspace over the existing filename
  2622. and enter the filename you wish to load.
  2623.  
  2624.  
  2625. ┌────────────────────────────────────────────────────────────────────┐
  2626. │                     2.8.1 ■ CONTROL CHARACTERS                     │
  2627. └────────────────────────────────────────────────────────────────────┘
  2628.  
  2629. Not all hosts will allow you to use control characters.  Regardless
  2630. of that, the capability to send any control character exists in your
  2631. keystroke macro editor.  The most commonly used control characters
  2632. are:
  2633.  
  2634.     INDIVIDUAL CONTROL CHARACTERS           SPECIAL KEYSTROKES
  2635.     ----------------------------------      ----------------------
  2636.     ^G ... Beep                             ^[[A ... Up arrow
  2637.     ^L ... Clear screen (top of form)       ^[[B ... Down arrow
  2638.     ^M ... Carriage return                  ^[[C ... Right arrow
  2639.     ^C ... Break (on some hosts)            ^[[D ... Left arrow
  2640.     ^H ... Backspace                        ^[[H ... Home key
  2641.     ^[ ... Escape character (ESC)           ^[[K ... End key
  2642.     ^S ... Pause data transmission (X-OFF)  ^[[L ... Control home
  2643.     ^Q ... Resume data transmission (X-ON)
  2644.  
  2645.  
  2646. ┌────────────────────────────────────────────────────────────────────┐
  2647. │                       2.8.2 ■ TEXT VARIABLES                       │
  2648. └────────────────────────────────────────────────────────────────────┘
  2649.  
  2650. A special feature of RIPterm allows it to understand what a text
  2651. variable is.  A text variable is a string of text that RIPterm knows
  2652. represents something more.  For example, the text variable $DATE$ is
  2653. known to represent the current date on your system.  The host may ask
  2654. your system what the values of one or more of these variables are,
  2655. and if your terminal knows that particular text variable, it will
  2656. send that information to the host.
  2657.  
  2658. There are two types of text variables.  There are built-in text
  2659. variables that RIPterm will ALWAYS know about.  Then there are also
  2660. user text variables that can contain a variety of information
  2661. depending on what the RIPterm user entered at the time the variable
  2662. was created.  For example, the host might ask you what the contents
  2663. of the $FULL_NAME$ variable is, and if RIPterm doesn't know, it would
  2664. pop-up a field on the screen and ask you about it.  From then on,
  2665. RIPterm will remember that piece of information for the next time it
  2666. is needed by a host.
  2667.  
  2668. You may use either the pre-defined text variables, or the user text
  2669. variables at any place that allows text variables (i.e., keystroke
  2670. macros).
  2671.  
  2672.  
  2673. ┌────────────────────────────────────────────────────────────────────┐
  2674. │                   2.8.2.1 ■ USER TEXT VARIABLES                    │
  2675. └────────────────────────────────────────────────────────────────────┘
  2676.  
  2677. User text variables are text variables that you create.  A host might
  2678. tell you, "Create this text variable for me", or you might create one
  2679. yourself.  The difference is really unimportant.  However, a brief
  2680. explanation of their purpose might prove insightful.
  2681.  
  2682. User text variables are used to store information either permanently,
  2683. or temporarily.  This information can then be re-used without you
  2684. having to type them in again.  The time-saving aspect of this feature
  2685. is only one small benefit of its ability.  Having the capability to
  2686. store information over potentially long periods of time is VERY
  2687. useful!
  2688.  
  2689. There are three types of user text variables:
  2690.  
  2691. 1. Permanent (database)    variables
  2692. 2. Temporary (in memory)   variables
  2693. 3. Volatile  (discardable) variables
  2694.  
  2695. The significance of each type of variable is described below:
  2696.  
  2697. ┌────────────────────────────────┐
  2698. │ PERMANENT (DATABASE) VARIABLES │
  2699. └────────────────────────────────┘
  2700.  
  2701. Permanent text variables are saved in a local RIPterm database file
  2702. called RIPTERM.DB.  This file is automatically indexed for high-speed
  2703. retrieval of information.  The index file for this database is called
  2704. RIPTERM.IDX.  Both files are stored in the current RIPterm directory
  2705. for safe keeping.  Any permanent text variable that is created is
  2706. stored in this file.
  2707.  
  2708. A permanent text variable can be created by yourself manually by
  2709. choosing option "Store Data" from the Data menu, or interactively by
  2710. a host via a special RIPscrip command ("Define Text Variable").  Once
  2711. you create a variables, they are stored forever, or until you either
  2712. delete the database file, or modify the entry.  These variables may
  2713. be accessed by yourself, or a host (if you wish it).  This can be
  2714. quite useful in preventing you from having to type the same
  2715. information in over and over again in future on-line sessions. Imagine
  2716. if you could sign-up on a host without having to type a single
  2717. character?  Sound too good to be true?  With text variables, you (and
  2718. other sysops) could do this!
  2719.  
  2720. ┌─────────────────────────────────┐
  2721. │ TEMPORARY (IN MEMORY) VARIABLES │
  2722. └─────────────────────────────────┘
  2723.  
  2724. Temporary (in memory) text variables are just like permanent text
  2725. variables, except that they are not stored in a database file.  They
  2726. are stored in your computer's memory.  They remain until you exit
  2727. RIPterm.  Other than that, they are identical in nature to permanent
  2728. text variables.  Until you exit RIPterm, they will exist and will be
  2729. accessible to you (via macros), or to a host.
  2730.  
  2731. ┌──────────────────────────────────┐
  2732. │ VOLATILE (DISCARDABLE) VARIABLES │
  2733. └──────────────────────────────────┘
  2734.  
  2735. A volatile (discardable) text variable is somewhat different than the
  2736. previously described text variables.  They do not remain in memory or
  2737. in any database for any period of time.  They are used solely to ask
  2738. you a simple question, transmit the information to the host, then the
  2739. contents of the variable are destroyed forever.  Why would you (or a
  2740. host) want something like this?  This question is answered
  2741. differently for YOU or for a host.
  2742.  
  2743. A volatile text variable for you can be useful during keystroke
  2744. macros.  Let's say you have a very complex macro that you've devised
  2745. for doing something in a game (for example) to another user on the
  2746. host.  Should you have to edit the macro each time you want to
  2747. use it for someone different?  Of course not!  Simply place a
  2748. reference to an "undefined" text variable in your macro.  When you
  2749. execute the macro, RIPterm will look through its list of text
  2750. variables (pre-defined, in-memory and permanent), and if it doesn't
  2751. find a corresponding variable, it would pop-up a quick dialog box
  2752. asking you to enter something for that variable.  Whatever you type
  2753. into that dialog box for the variable is replaced in your macro right
  2754. then and there, and is immediately discarded after the macro is
  2755. finished.  For example, let's say you have the following macro setup
  2756. to attack another player in a game on some host you call:
  2757.  
  2758.     F2:  ATTACK $USERNAME$ FIERCELY^m
  2759.  
  2760. When you execute macro F2, RIPterm will transmit "ATTACK " to the
  2761. host, then find the text variable $USERNAME$ in it.  It will check
  2762. its internal tables for this variable, and if it doesn't find it, it
  2763. will pop-up a window asking you to enter the following:
  2764.  
  2765.       ╔════════════════════════════════════════════════════════╗
  2766.       ║                Please enter "USERNAME"                 ║
  2767.       ║  ┌──────────────────────────────────────────────────┐  ║
  2768.       ║  │ █                                                │  ║
  2769.       ║  └──────────────────────────────────────────────────┘  ║
  2770.       ╚════════════════════════════════════════════════════════╝
  2771.  
  2772. Simply type in the name of the user you wish to attack, and the
  2773. result will be sent to the host in place of the variable name
  2774. $USERNAME$.  After that, the remainder of the macro will be
  2775. transmitted to the host (i.e., " FIERCELY") followed by a carriage
  2776. return (^M is the carriage return).  Once the macro is complete, the
  2777. contents of USERNAME will not exist (unless it was a previously
  2778. defined "permanent" text variable or a Temporary (in memory) text
  2779. variable.
  2780.  
  2781. A host can also ask you to enter something for a volatile text
  2782. variable.  Why would a host want to do this and not save the response
  2783. somewhere?  What if you asked a host to download a file.  It could
  2784. present you with a menu like the following:
  2785.  
  2786.             ╔═══════════════════════════════════════════╗
  2787.             ║                File Download              ║
  2788.             ║  ┌─────────────┐  ┌────────────────────┐  ║
  2789.             ║  │  Protocols  │  │   Enter Filename   │  ║
  2790.             ║  ├─────────┬───┤  └────────────────────┘  ║
  2791.             ║  │ X-Modem │   │  ╔════════════════════╗  ║
  2792.             ║  │ Y-Modem │   │  ║   Begin Download   ║  ║
  2793.             ║  │ Z-Modem │ X │  ╚════════════════════╝  ║
  2794.             ║  │ Kermit  │   │  ┌────────────────────┐  ║
  2795.             ║  └─────────┴───┘  │  Cancel Download!  │  ║
  2796.             ║                   └────────────────────┘  ║
  2797.             ╚═══════════════════════════════════════════╝
  2798.  
  2799. The options on the left allow you to specify the file transfer
  2800. protocol that you wish to use for the transfer.  The "Enter Filename"
  2801. button though is the one we're interested in.  When you click on this
  2802. button, you would think that RIPterm should pop-up a dialog box on
  2803. your screen asking you what filename you want to download, right?
  2804. Would you think that the filename you enter should become a permanent
  2805. part of RIPterm's configuration?  Of course not.  It saved only
  2806. temporarily until such time as you click on either "Begin Download"
  2807. or "Cancel Download!".  Its value is used specifically when you click
  2808. on "Begin Download" whereby RIPterm looks at all of the buttons on
  2809. the screen and instructs the host to begin the download in a certain
  2810. way (e.g., using Z-Modem protocol to download file XYZ.EXE for
  2811. example).  As you can clearly see, you would not want the filename
  2812. field to be part of your permanent RIPterm configuration.  In this
  2813. manner, volatile text variables can be extremely useful!
  2814.  
  2815.  
  2816. ┌────────────────────────────────────────────────────────────────────┐
  2817. │               2.8.2.2 ■ USER TEXT VARIABLE SECURITY                │
  2818. └────────────────────────────────────────────────────────────────────┘
  2819.  
  2820. All this discussion about user text variables, and hosts asking your
  2821. terminal for information, you might be concerned about calling some
  2822. host you've never called before and letting it ask your terminal
  2823. questions about itself (and YOU)!  We don't blame you for thinking
  2824. this.  That is why we've put a security precaution into RIPterm.  It
  2825. is called "Data Security".  This option (available from the Data
  2826. menu) allows you to preview any user text variable question to
  2827. determine if you really and truly want to send that information to
  2828. the host.  This allows you to edit the text variable that will be
  2829. sent to the host so that you are in control at all times of what
  2830. information is sent to the host.  Any variable that is queried by the
  2831. host will be prompted on your screen allowing you to edit the
  2832. response.  In the event that you do not wish to divulge the
  2833. information to the host, simply backspace over your text and send a
  2834. "blank" response.  In the event that the host won't permit a blank
  2835. response, enter something like "NONE" or "N/A".
  2836.  
  2837. If this mode is disabled, you may still be prompted to edit your
  2838. variable if the host asks for an "interactive query".  The host can
  2839. ask for a non-interactive text variable query, which means that the
  2840. host will "try" to ask your terminal the contents of a text variable.
  2841. If the variable exists, it will send the contents to the host without
  2842. you even knowing that it was sent!  In some ways, it is up to the
  2843. honor of the sysop of the host to set all variable queries as
  2844. interactive by default.  But considering the fact that this is not an
  2845. entirely "equal" world, having the ability to override variable
  2846. queries with a Data Security option becomes quite important.
  2847.  
  2848. This option defaults to "ON" when RIPterm is initially installed.  In
  2849. other words, all data queries are considered "secure" by default.  It
  2850. is up to you to disable this security measure.  Use this option with
  2851. caution if you're not sure about trusting the hosts you call.
  2852.  
  2853. As a note worth mentioning, a RIPscrip command to query the contents
  2854. of your terminal's text variables may be possible if you read an
  2855. electronic mail message from an ingenious user who knows the RIPscrip
  2856. protocol language.  In situations like this, you would definitely
  2857. want to use data security mode to prevent unauthorized information
  2858. transmittal to other people (e.g., credit card numbers, or other
  2859. information).
  2860.  
  2861.  
  2862. ┌────────────────────────────────────────────────────────────────────┐
  2863. │                2.8.2.3 ■ PRE-DEFINED TEXT VARIABLES                │
  2864. └────────────────────────────────────────────────────────────────────┘
  2865.  
  2866. Pre-defined text variables are something that RIPterm always knows
  2867. about.  They are "built-in" to RIPterm, and a host can always get an
  2868. answer to.  These types of variables are defined to provide the host
  2869. with some kind of information about your terminal software, not about
  2870. something you (or your terminal) knows.  In other words, pre-defined
  2871. text variables can be used to send a piece of information to the host
  2872. saying "what time is it", or "what is the date where you are", or
  2873. "where is the mouse located?".  They function exactly like any other
  2874. text variable except that RIPterm knows they exist even if you
  2875. haven't created them yet. By nature, the values that these variables
  2876. return to the host are rarely the same.  They change depending on the
  2877. nature of each variable.
  2878.  
  2879. The following is a list of pre-defined text variables:
  2880.  
  2881.  
  2882.     $DATE$ ... Date in short format (e.g., 12/19/92)
  2883.  
  2884.     This Text Variable will be transformed into the current Date.
  2885.     It will be displayed in the format MM/DD/YY.
  2886.  
  2887.         Example:  $DATE$ = 12/19/92
  2888.  
  2889.     -----------------------------------------------------------------
  2890.  
  2891.     $MONTH$ ... Month Name
  2892.  
  2893.     This text variable will be transformed into the name of the
  2894.     current month.  It will be not abbreviated (e.g., "November"
  2895.     instead of "Nov")
  2896.  
  2897.         Example:  $MONTH$ = December
  2898.  
  2899.     -----------------------------------------------------------------
  2900.  
  2901.     $MONTHNUM$ ... Month (in format 1-12)
  2902.  
  2903.     This text variable is transformed into a number representing
  2904.     the current month.  January=01 and December=12.  Therefore,
  2905.     the possible values for $MONTHNUM$ can range from 1 to 12.
  2906.  
  2907.         Example:  $MONTHNUM$ = 12
  2908.  
  2909.     -----------------------------------------------------------------
  2910.  
  2911.     $DAY$ ... Day in numeric form (e.g., 31)
  2912.  
  2913.     This text variable is transformed into a number representing the
  2914.     day of the month.  The range of values for this variable are from
  2915.     01-31.
  2916.  
  2917.         Example:  $DAY$ = 05
  2918.  
  2919.     -----------------------------------------------------------------
  2920.  
  2921.     $DOY$ ... Day of year (001-366)
  2922.  
  2923.     This text variable will be transformed into a number representing
  2924.     the day of the current year.  Since a year contains 365 days
  2925.     (unless it is a leap-year where it contains 366), then the
  2926.     possible values that $DOY$ can be are 001-366.
  2927.  
  2928.         Example: $DOY$ = 214
  2929.  
  2930.     -----------------------------------------------------------------
  2931.  
  2932.     $YEAR$ ... 2 digit year (without century) (00-99)
  2933.  
  2934.     This text variable will be transformed into a two-digit number
  2935.     representing the current year.
  2936.  
  2937.         Example: $YEAR$ = 92
  2938.  
  2939.     -----------------------------------------------------------------
  2940.  
  2941.     $FYEAR$ ... 4 digit year (with century) (0000-9999)
  2942.  
  2943.     This text variable will be transformed into a four-digit number
  2944.     that represents the current year.
  2945.  
  2946.         Example:  $FYEAR$ = 1992
  2947.  
  2948.     -----------------------------------------------------------------
  2949.  
  2950.     $TIME$ ... Time in standard format (e.g., 12:03:14)
  2951.  
  2952.     This text variable will be transformed into the current time.
  2953.     The time will be in military format (hours from 00-23).
  2954.  
  2955.         Example:  $TIME$ = 18:09:33
  2956.  
  2957.     -----------------------------------------------------------------
  2958.  
  2959.     $HOUR$ .... Hour (format HH) - normal style
  2960.  
  2961.     This text variable will be transformed into a two-digit number
  2962.     representing the current hour.  This variable may be anywhere
  2963.     from 01-12.  This does not use military format.
  2964.  
  2965.         Example:  $HOUR$ = 11
  2966.  
  2967.     -----------------------------------------------------------------
  2968.  
  2969.     $MHOUR$ ... Hour (format HH) - Military style
  2970.  
  2971.     This text variable will be transformed into a two-digit number
  2972.     representing the current hour in military format.  This variable
  2973.     may range anywhere from 00-23.
  2974.  
  2975.         Example: $MHOUR$ = 17
  2976.  
  2977.     -----------------------------------------------------------------
  2978.  
  2979.     $MIN$ ... Minutes (00-59)
  2980.  
  2981.     This text variable will be transformed into a two-digit number
  2982.     representing the current minutes in the hour.  Possible values
  2983.     for this variable are 00-59.
  2984.  
  2985.         Example:  $MIN$ = 45
  2986.  
  2987.     -----------------------------------------------------------------
  2988.  
  2989.     $SEC$ ... Seconds (00-59)
  2990.  
  2991.     This text variable will be transformed into a two-digit number
  2992.     representing the current seconds of the minute.  Possible values
  2993.     for this variable are 00-59.
  2994.  
  2995.         Example: $SEC$ = 59
  2996.  
  2997.     -----------------------------------------------------------------
  2998.  
  2999.     $AMPM$ ... Returns either AM or PM depending on time
  3000.  
  3001.     This text variable will be transformed into a two-character
  3002.     value of either "AM" or "PM" depending on what time it is.
  3003.  
  3004.         Example: $AMPM$ = PM
  3005.  
  3006.     -----------------------------------------------------------------
  3007.  
  3008.     $DATETIME$ ... Date & Time (e.g., Sat Dec 19 14:38:50 1992)
  3009.  
  3010.     This text variable will be transformed into a combination date
  3011.     and time.  The format is somewhat different than standard
  3012.     time/date notation.  The format used is:
  3013.  
  3014.         DAY-OF-WEEK   MONTH   DAY-OF-MONTH  HH:MM:SS  YEAR
  3015.  
  3016.         Example:  $DATETIME$ = Sat Dec 19 14:38:50 1992
  3017.  
  3018.     -----------------------------------------------------------------
  3019.  
  3020.     $TIMEZONE$ ... Time Zone or "NONE" if unknown (e.g., Pacific)
  3021.  
  3022.     This text variable will be transformed into a a word/phrase that
  3023.     describes the current time-zone you are in.  This may be returned
  3024.     as anything like "PST" for Pacific Standard Time, "EDT" for
  3025.     Eastern Daylight Time, etc.  If the time-zone is not set on your
  3026.     system, this variable will respond with "NONE".
  3027.  
  3028.         Example: $TIMEZONE$ = PST
  3029.  
  3030.     -----------------------------------------------------------------
  3031.  
  3032.     $DOW$ ... Day of week fully spelled out (e.g., Friday)
  3033.  
  3034.     This text variable will be transformed into the current day
  3035.     of the week.  The name will be fully spelled out.  This
  3036.     variable can be any of the values: Sunday, Monday, Tuesday,
  3037.     Wednesday, Thursday, Friday and Saturday.
  3038.  
  3039.         Example:  $DOW$ = Saturday
  3040.  
  3041.     -----------------------------------------------------------------
  3042.  
  3043.     $ADOW$ ... Abbreviated Day of Week (e.g., Mon, Tue, etc.)
  3044.  
  3045.     This text variable will be transformed into the current day
  3046.     of the week, in abbreviated form.  This variable may be any
  3047.     of the following values: Sun, Mon, Tue, Wed, Thu, Fri and Sat.
  3048.  
  3049.         Example:  $ADOW$ = Mon
  3050.  
  3051.     -----------------------------------------------------------------
  3052.  
  3053.     $WDAY$ ... Weekday where 0 is Sunday (0-6)
  3054.  
  3055.     This text variable will be transformed into a one-digit number
  3056.     representing the number of the day of the week.  Possible values
  3057.     for this variable are 0-6, where 0=Sunday (the first day in the
  3058.     week).
  3059.  
  3060.         Example: $WDAY$ = 2
  3061.  
  3062.     -----------------------------------------------------------------
  3063.  
  3064.     $WOY$ ... Week of current year 00-53; Sunday=1st Day of Week
  3065.  
  3066.     This text variable will be transformed into a number from 00-53,
  3067.     representing the week number in the current year.  Even though
  3068.     there are 52 weeks in a year, a week might not begin exactly on
  3069.     the first day of the year, so a maximum value for this variable
  3070.     can be 53 under these circumstances.  For this variable, SUNDAY
  3071.     is considered to be the first day of the week.
  3072.  
  3073.         Example:  $WOY$ = 32
  3074.  
  3075.     -----------------------------------------------------------------
  3076.  
  3077.     $WOYM$ ... Week of current year 00-53; Monday=1st Day of Week
  3078.  
  3079.     This text variable will be transformed into a number from 00-53,
  3080.     representing the week number in the current year.  Even though
  3081.     there are 52 weeks in a year, a week might not begin exactly on
  3082.     the first day of the year, so a maximum value for this variable
  3083.     can be 53 under these circumstances.  For this Variable, MONDAY
  3084.     is considered to be the first day of the week.
  3085.  
  3086.         Example:  $WOYM$ = 32
  3087.  
  3088.     -----------------------------------------------------------------
  3089.  
  3090.     $RIPVER$ ... RIPscrip version (e.g., "RIPSCRIP015100")
  3091.  
  3092.     This text variable will be transformed into a key-phrase which
  3093.     will identify a RIPscrip software package.  It is designed to
  3094.     be used by a host to detect what version of RIPscrip
  3095.     graphics your terminal can support.  When this text variable
  3096.     is used, it will respond back with "RIPSCRIP" followed by
  3097.     the full version number (e.g., 01.51.00), without the periods.
  3098.  
  3099.         Example: $RIPVER$ = RIPSCRIP015100
  3100.  
  3101.     -----------------------------------------------------------------
  3102.  
  3103.     $STATBAR$ ... If Status Bar is on, returns YES, otherwise NO
  3104.  
  3105.     This text variable will be transformed into a "YES" if the status
  3106.     bar is currently ON.  If the Status Bar is not visible, then this
  3107.     variable will be "NO".
  3108.  
  3109.         Example:  $STATBAR$ = YES
  3110.  
  3111.     -----------------------------------------------------------------
  3112.  
  3113.     $X$ ... X Mouse location   (format: XXXX)
  3114.  
  3115.     This text variable is for reporting the current X location of
  3116.     the mouse to the host.  This could be used interactively by the
  3117.     host (or a game on the host) to determine the location of the
  3118.     mouse cursor.  Only the X value of the mouse (X,Y) location is
  3119.     returned to the host.  The value will be 0000-9999 depending on
  3120.     what the current position is.
  3121.  
  3122.         Example:  $X$ = 0523
  3123.  
  3124.     -----------------------------------------------------------------
  3125.  
  3126.     $Y$ ... Y Mouse location   (format: YYYY)
  3127.  
  3128.     This text variable is for reporting the current Y location of
  3129.     the mouse to the host.  This could be used interactively by the
  3130.     host (or a game on the host) to determine the location of the
  3131.     mouse cursor.  Only the Y value of the mouse (X,Y) location is
  3132.     returned to the host.  The value will be 0000-9999 depending on
  3133.     what the current position is.
  3134.  
  3135.         Example:  $Y$ = 0244
  3136.  
  3137.     -----------------------------------------------------------------
  3138.  
  3139.     $XY$ ... X/Y Mouse Location (format: XXXX:YYYY)
  3140.  
  3141.     This text variable will be transformed into a combination of
  3142.     both the X and Y locations of the mouse.  A colon (:) is used to
  3143.     separate the two values.  Either the X or Y values may range from
  3144.     0000-9999 depending on the current location.  The format that
  3145.     this value takes on is:  XXXX:YYYY
  3146.  
  3147.         Example:  $XY$ = 0297:0321
  3148.  
  3149.     -----------------------------------------------------------------
  3150.  
  3151.     $XYM$ ... X, Y & button status (format: XXXX:YYYY:LMR)
  3152.  
  3153.     This text variable will be transformed into a combination of the
  3154.     X and Y mouse location, and a status of which mouse buttons are
  3155.     pressed (if any).
  3156.  
  3157.     The format of the returned text is XXXX:YYYY:LMR where XXXX is
  3158.     the X cursor location in the range 0000-9999.  YYYY is the Y
  3159.     cursor location in the range 0000-9999.  Finally, LMR stands for
  3160.     Left/Middle/Right.  If either of these buttons are depressed
  3161.     (clicked), then the corresponding position will contain a 1.  If
  3162.     a button is NOT depressed, then it will contain a 0.
  3163.  
  3164.         Example:  $XYM$ = 0123:0297:110
  3165.  
  3166.     This means that the (X,Y) location of the cursor is (0123,0297),
  3167.     and that the left and middle buttons are depressed, but that the
  3168.     right mouse button is not depressed.
  3169.  
  3170.     -----------------------------------------------------------------
  3171.  
  3172.     $M$ ... Mouse Button Status: LMR (e.g., 101)
  3173.  
  3174.     This text variable will be transformed into a 3-character code
  3175.     representing what the status of each mouse button is.  This
  3176.     variable can work with either 2-button mice, or 3-button mice.
  3177.     In either event, the format of the code is LMR where L = Left,
  3178.     M = Middle (if any), and R = Right.  If any of these buttons are
  3179.     depressed (i.e., clicked), then the code for that button would be
  3180.     a "1".  If the button is not depressed, it is a "0".  So, a value
  3181.     of "100" would mean that the left mouse button is depressed, but
  3182.     none of the others are.
  3183.  
  3184.         Example:  $M$ = 001
  3185.  
  3186.     -----------------------------------------------------------------
  3187.  
  3188.     $MSTAT$ ... Mouse Status (format: YES/NO)
  3189.  
  3190.     This text variable will be transformed into a "YES" if there is
  3191.     a mouse installed on the RIPterm computer.  If no mouse is
  3192.     installed, this variable will contain "NO".
  3193.  
  3194.         Example:  $MSTAT$ = YES
  3195.  
  3196.     ┌───────────────────────┐
  3197.     │ Active Text Variables │
  3198.     └───────────────────────┘
  3199.  
  3200.     These text variables are somewhat different than the other text
  3201.     variables described above.  Rather than send something back to
  3202.     the host, it performs a specific operation, such as toggling the
  3203.     status line.  In this respect, it is considered an ACTIVE TEXT
  3204.     VARIABLE.  It evaluates to a null string (nothing).
  3205.  
  3206.  
  3207.     $SBARON$ ... Turn ON the Status Line
  3208.  
  3209.     This text variable's sole purpose in life is to enable the Status
  3210.     Line.  It evaluates to a null string (nothing).
  3211.  
  3212.     -----------------------------------------------------------------
  3213.  
  3214.     $SBAROFF$ ... Turn OFF the Status Line
  3215.  
  3216.     This text variable's sole purpose in life is to disable the Status
  3217.     Line.  It evaluates to a null string (nothing).
  3218.  
  3219.     -----------------------------------------------------------------
  3220.  
  3221.     $ETW$ ... Erase Text Window
  3222.  
  3223.     This command erases the current text window (much like a clear
  3224.     screen code does).  This command is particularly useful in host
  3225.     commands when you click on a mouse area, and after it is finished
  3226.     clicking, it could erase the text window THEN transmit the
  3227.     remainder of the host command (if any) to the host.
  3228.  
  3229.     -----------------------------------------------------------------
  3230.  
  3231.     $DTW$ ... Disable Text Window
  3232.  
  3233.     This text variable disables the current text window (preventing
  3234.     any received text from showing up on screen).
  3235.  
  3236.     -----------------------------------------------------------------
  3237.  
  3238.     $EGW$ ... Erase Graphics Window
  3239.  
  3240.     This text variable it erases the current graphics window (much
  3241.     like a reset windows command does).  This command is particularly
  3242.     useful in host commands when you click on a mouse area, and after
  3243.     it is finished clicking, it could erase the graphics window THEN
  3244.     transmit the remainder of the host command (if any) to the host.
  3245.  
  3246.     -----------------------------------------------------------------
  3247.  
  3248.     $MKILL$ ... Kill all Mouse Fields currently defined
  3249.  
  3250.     This text variable deletes all currently defined mouse fields
  3251.     exactly like the RIPscrip RIP_KILL_MOUSE_FIELDS command does. The
  3252.     net benefit of this is that when the user clicks on a mouse
  3253.     button, the mouse fields are removed, but the graphics remain on
  3254.     the screen so that the fields could be subsequently re-defined
  3255.     quickly and easily without having to re-transmit an identical
  3256.     menu over again.
  3257.  
  3258.     -----------------------------------------------------------------
  3259.  
  3260.     $BEEP$ ... Beeps the terminal (like a CTRL-G does)
  3261.  
  3262.     This command issues a beep to the terminal, thus producing
  3263.     a CTRL-G sound.
  3264.  
  3265.     -----------------------------------------------------------------
  3266.  
  3267.     $BLIP$ ... Makes a short "blipping" sound
  3268.  
  3269.     This active text variable is much like the BEEP variable, except
  3270.     that the sound produced is different.  It produces a sound more
  3271.     akin to a "barrier" sound; something that sounds like you're
  3272.     bumping into a wall or something to that effect.
  3273.  
  3274.     -----------------------------------------------------------------
  3275.  
  3276.     $MUSIC$ ... Makes a musical (cheerful) sound
  3277.  
  3278.     This active text variable also produces an audio result.  The
  3279.     sound that is generated is a cheerful sound, representing some
  3280.     kind of success.  The sound is exactly the same as the sound you
  3281.     would hear when you receive a successful download, or when you
  3282.     achieve a connection when dialing the modem in RIPterm.
  3283.  
  3284.     -----------------------------------------------------------------
  3285.  
  3286.     $PCB$ ... Paste Clip Board at last location
  3287.  
  3288.     This command pastes the contents of the clipboard at the last
  3289.     location where the clipboard was "clipped" from.  This even works
  3290.     with icons that are loaded.  The last location taken in this
  3291.     situation, is the location the icon was stamped when it was
  3292.     originally loaded.  This text variable is very useful in
  3293.     situations where you want to "pop-up" a dialog box on the screen
  3294.     (saving the previous area behind the dialog onto the clipboard),
  3295.     and when the user clicks on the "OK" button, restoring the screen
  3296.     contents (by adding a $PCB$ in the host command string).
  3297.  
  3298.     -----------------------------------------------------------------
  3299.  
  3300.     $SMF$ ... Save Mouse Fields
  3301.  
  3302.     This text variable will save all currently defined mouse fields
  3303.     and mouse buttons to a temporary file for later retrieval.  This
  3304.     is designed especially for the graphical designer who wishes to
  3305.     pop-up a dialog box on the screen with one or more mouse fields,
  3306.     and when finished, to restore the screen and original mouse
  3307.     fields (if any) so that the user is not left "floating".  This
  3308.     command is intended to be used with the restore mouse fields text
  3309.     variable $RMF$.
  3310.  
  3311.     -----------------------------------------------------------------
  3312.  
  3313.     $RMF$ ... Restore Mouse Fields
  3314.  
  3315.     This text variable restores any previously saved mouse fields
  3316.     saved with the $SMF$ text variable.  You may have only one set of
  3317.     mouse fields saved at any one time.  If there were no mouse
  3318.     fields saved, or if the number of mouse fields that were saved
  3319.     was 0, then no mouse fields will be active.  Any fields that were
  3320.     defined at the time of this command's execution will be erased.
  3321.     Due to technical details, this should be the last piece of text
  3322.     or the last text variable in any mouse host command (or button
  3323.     host command). Having subsequent text variables or host command
  3324.     text after this variable (in a mouse field) can lead to
  3325.     unpredictable and potentially disastrous results.
  3326.  
  3327.     NOTE: You may restore mouse fields more than once if you wish.
  3328.           In other words, if you perform a "Save Mouse Fields"
  3329.           command, you may execute Restore Mouse Fields one or
  3330.           more times after that point.
  3331.  
  3332.     -----------------------------------------------------------------
  3333.  
  3334.     $COFF$ ... Disable the text cursor
  3335.  
  3336.     This command will physically shut off the ASCII text cursor that 
  3337.     is normally seen in the text window.  This is automatically reset
  3338.     whenever a $CON$ command (Cursor ON) or a Reset Windows command
  3339.     is received.
  3340.  
  3341.     -----------------------------------------------------------------
  3342.  
  3343.     $CON$ ... Re-displays the text cursor
  3344.  
  3345.     This command will physically turn ON the ASCII text cursor.  This
  3346.     is the exact opposite of the $COFF$ command which disables the
  3347.     text cursor.
  3348.  
  3349.     -----------------------------------------------------------------
  3350.  
  3351.     $STW$ ... Save text window information
  3352.  
  3353.     This command will physically store all of the text window 
  3354.     settings.  The window's X/Y dimensions are preserved, as is the
  3355.     current cursor location, ANSI attributes, cursor ON/OFF status
  3356.     and the vertical scrolling margins.  Even the current System Font
  3357.     will be saved (if necessary).
  3358.  
  3359.     -----------------------------------------------------------------
  3360.  
  3361.     $RTW$ ... Restore text window information
  3362.  
  3363.     This command will restore the text window to whatever settings
  3364.     were active when the $STW$ (save text window) command was issued.
  3365.     The cursor, ANSI attributes and any other piece of text window
  3366.     information will be restored (including the System Font setting).
  3367.  
  3368.     -----------------------------------------------------------------
  3369.  
  3370.     $SCB$ ... Save Clip Board
  3371.  
  3372.     This command will save the Clipboard to disk for later retrieval
  3373.     by a subsequent Query or Host Command.  If the clipboard does
  3374.     not exist, then the temporary file is deleted automatically to
  3375.     indicate to the Restore Clip Board that there shouldn't be a 
  3376.     clipboard active.
  3377.  
  3378.     -----------------------------------------------------------------
  3379.  
  3380.     $RCB$ ... Restore Clip Board
  3381.  
  3382.     This command restores the clipboard from the temporary disk file
  3383.     called RIPCLIP.BRD.  This file is created by $SCB$ (save clip
  3384.     board).  Not only is the actual clipboard contents saved, but
  3385.     so is the last clipboard location, so that the Paste Clip Board
  3386.     command ($PCB$) will restore the clipboard's location as well.
  3387.  
  3388.     -----------------------------------------------------------------
  3389.  
  3390.     $VT102ON$ ... Turn VT-102 emulation mode ON
  3391.  
  3392.     This command enabled the VT-102 terminal emulation mode.  This
  3393.     makes the following keystrokes send something to the Host:
  3394.  
  3395.                               F1 ...  ESC [ M
  3396.                               F2 ...  ESC [ N
  3397.                               F3 ...  ESC [ O
  3398.                               F4 ...  ESC [ P
  3399.                               F5 ...  ESC [ Q
  3400.                               F6 ...  ESC [ R
  3401.                               F7 ...  ESC [ S
  3402.                               F8 ...  ESC [ T
  3403.                               F9 ...  ESC [ U
  3404.                              F10 ...  ESC [ V
  3405.                             PGUP ...  ESC [ I
  3406.                             PGDN ...  ESC [ G
  3407.                             HOME ...  ESC [ H
  3408.                              END ...  ESC [ F
  3409.                           INSERT ...  ESC [ L
  3410.                        CURSOR UP ...  ESC [ A
  3411.                        CURSOR DN ...  ESC [ B
  3412.                      CURSOR LEFT ...  ESC [ C
  3413.                     CURSOR RIGHT ...  ESC [ D
  3414.  
  3415.     In addition, many ANSI escape sequences function slightly differently
  3416.     than in normal ANSI mode.  When in this mode, RIPterm tries to act
  3417.     like a VT-102 compatible terminal.
  3418.  
  3419.     The purpose of having this as a text variable is that the Host
  3420.     can instruct the terminal to enter this mode automatically, thus
  3421.     making it simpler on the user.
  3422.  
  3423.     -----------------------------------------------------------------
  3424.  
  3425.     $VT102OFF$ ... Turn VT-102 emulation mode OFF
  3426.  
  3427.     This variable disables the VT-102 mode, returning your
  3428.     keyboard to the standard keyboard operation.
  3429.  
  3430.     -----------------------------------------------------------------
  3431.  
  3432.     $DWAYON$ ... Turn Doorway Mode ON
  3433.  
  3434.     This variable enabled Doorway Mode.  This is intended to be used
  3435.     by a Host system that wishes to take advantage of the Doorway
  3436.     mode available in Marshall Dudley's Doorway (tm) software
  3437.     package.
  3438.  
  3439.     -----------------------------------------------------------------
  3440.  
  3441.     $DWAYOFF$ ... Turn Doorway Mode OFF
  3442.  
  3443.     This variable disabled the Doorway keyboard mode.  This will
  3444.     return the keyboard to normal operation.
  3445.  
  3446.     -----------------------------------------------------------------
  3447.  
  3448.     $SAVE$ ... Save graphics screen
  3449.  
  3450.     The SAVE variable will completely save the contents of the entire
  3451.     graphics screen to a disk file called RIPTERM.SAV.  No Mouse
  3452.     Fields, Text Window locations or Clipboard data are saved - just
  3453.     the graphics screen.  The entire 640x350 region is saved to disk.
  3454.  
  3455.     If you wish to save the entire state of the RIPterm system, use
  3456.     the following text variables all at the same time (spaces are
  3457.     added for clarity):
  3458.  
  3459.               $SAVE$ $STW$ $SCB$ $SMF$
  3460.                  \     \     \     \
  3461.                   \     \     \     --- Save Mouse Fields
  3462.                    \     \     \
  3463.                     \     \     ------- Save ClipBoard
  3464.                      \     \
  3465.                       \     ----------- Save Text Window
  3466.                        \
  3467.                         --------------- Save Graphics Screen
  3468.  
  3469.  
  3470.     -----------------------------------------------------------------
  3471.  
  3472.     $RESTORE$ ... Restore graphics screen
  3473.  
  3474.     The RESTORE command will read the saved file RIPTERM.SAV in from
  3475.     disk and restore the graphics as they were originally saved with
  3476.     the $SAVE$ command.  Only the graphics screen is restored, not
  3477.     the Clipboard, Mouse Fields or Text Window settings.  To restore
  3478.     the entire context of the graphics environment, issue the 
  3479.     following text variables:
  3480.  
  3481.               $RESTORE$ $STW$ $SCB$ $SMF$
  3482.                  \        \     \     \
  3483.                   \        \     \     --- Restore Mouse Fields
  3484.                    \        \     \
  3485.                     \        \     ------- Restore ClipBoard
  3486.                      \        \
  3487.                       \        ----------- Restore Text Window
  3488.                        \
  3489.                         ------------------ Restore Graphics Screen
  3490.  
  3491.  
  3492.     -----------------------------------------------------------------
  3493.  
  3494.     $SAVE0$-$SAVE9$ & $RESTORE0$-$RESTORE9$ ... Save/Restore screens
  3495.  
  3496.     These ten text variables are identical in nature with $SAVE$
  3497.     described above with sole exception to the fact that the temp
  3498.     files (RIPTERM0.SAV - RIPTERM9.SAV) are immediately deleted
  3499.     when restored.  The $SAVE$ and $RESTORE$ commands do not do this.
  3500.     With this, you can keep restoring screens if you use $SAVE$.
  3501.     These ten variables are provided so that you can have more than
  3502.     one screen saved simultaneously.
  3503.  
  3504.     -----------------------------------------------------------------
  3505.  
  3506.     $HKEYON$ ... Enable Button Hotkeys
  3507.  
  3508.     This option enables button hotkeys.  Any Button that is created
  3509.     by a BBS that has a hotkey will be activated if you hit the
  3510.     corresponding key on your keyboard.  This will light-up the
  3511.     Scroll-Lock key on your keyboard indicating that Button Hotkey
  3512.     mode is ON.
  3513.  
  3514.     -----------------------------------------------------------------
  3515.  
  3516.     $HKEYOFF$ ... Disable Button Hotkeys
  3517.  
  3518.     This option disables button hotkeys.  Any Button that is created
  3519.     by a BBS that has a hotkey associated with it, will not be
  3520.     activated even if the user hits that key on his keyboard.  The
  3521.     only way to activate a button in this mode is with the mouse.
  3522.     The Scroll-Lock key on your keyboard will go dim, indicating
  3523.     that Button Hotkey Mode is disabled.
  3524.  
  3525.     -----------------------------------------------------------------
  3526.  
  3527.     $TABON$ ... Enable TAB to execute mouse fields
  3528.  
  3529.     When this variable is processed, you can use the TAB key to
  3530.     navigate through the Mouse/Button fields on your screen.  In
  3531.     this mode, you can access the fields without a mouse.  The side-
  3532.     effect is that the TAB key cannot be used directly with the Host.
  3533.  
  3534.     -----------------------------------------------------------------
  3535.  
  3536.     $TABOFF$ ... Disable TAB to execute mouse fields
  3537.  
  3538.     When this variable is processed, you cannot use the TAB key to
  3539.     navigate throug the Mouse/Button fields on your screen.  In this
  3540.     mode, whenever the TAB key is hit, it is sent directly to the
  3541.     Host as a TAB character.  Any fields that are already hilighted
  3542.     when this variable is received will be de-hilighted.
  3543.  
  3544.  
  3545.  
  3546. ┌────────────────────────────────────────────────────────────────────┐
  3547. │        2.8.2.4 ■ SPECIAL TEXT VARIABLES - LOCAL RIP PLAYBACK       │
  3548. └────────────────────────────────────────────────────────────────────┘
  3549.  
  3550. You can re-play a .RIP file that you have locally on your hard disk
  3551. from a keystroke macro easily.  The format of the variable is
  3552. somewhat different than user variables, or pre-defined text
  3553. variables.  After the initial dollar sign ($), enter the greater-than
  3554. symbol (>) followed by the filename (with or without the .RIP
  3555. extension), then ending in another dollar sign ($).  Several examples
  3556. of this are as follows:
  3557.  
  3558.     $>MYFILE.RIP$
  3559.     $>FILE1$
  3560.     $>FILE1.RIP$$>FILE2.RIP$$FILE3$
  3561.     $>ANSIFILE.ANS$
  3562.  
  3563. Note in the last example, a file extension other than .RIP was used.
  3564. You are not limited to playing back local .RIP files.  In fact, you
  3565. can play-back any file you want.  You could load any simple text
  3566. file, ANSI picture image, or other such thing.  When loaded, the data
  3567. is not sent to the host; it is strictly echoed on your local screen.
  3568. If the file is a .RIP file, it will replay any graphics that were in
  3569. the file and if any Mouse Regions are defined, it will create those
  3570. fields for you as well, thus allowing you to pop-up dialog screens or
  3571. other such things that are not built-in to RIPterm normally.
  3572.  
  3573. Each "local RIP playback" variable you enter will search for the .RIP
  3574. file in the current host's icon directory.  If it cannot find the
  3575. file in that directory, it will check the ICONS\ directory.
  3576.  
  3577. If you have RIPaint, you could conceivably use this mode to place a
  3578. dialog box on your screen allowing you to alter your modems setup
  3579. quickly with your mouse, dial particular phone numbers, display an
  3580. ANSI text file, or other such things.
  3581.  
  3582.  
  3583. ┌────────────────────────────────────────────────────────────────────┐
  3584. │                        2.8.3 ■ POP-UP LISTS                        │
  3585. └────────────────────────────────────────────────────────────────────┘
  3586.  
  3587. In your keystroke macros you can take advantage of a unique feature
  3588. of RIPterm - popup pick-lists.  A popup pick-list is simply a list
  3589. that pops up allowing you to choose from one of several available
  3590. values.  Whichever entry in the list you choose will be inserted into
  3591. your keystroke macro in place of the list definition.
  3592.  
  3593. In order to use popup pick-lists in your keystroke macros, you must
  3594. define the list in the text of your macro.
  3595.  
  3596. A list is created by putting the special list instructions inside of
  3597. two parenthesis (( and )).  The list instructions consist of an
  3598. optional question, followed by one or more entries to put in the
  3599. List.  For example, ((Send E-Mail to?::Sysop,Cosysop,Joe)) says to
  3600. Pop-Up a list asking you "Send E-Mail to?", giving you the choices of
  3601. "Sysop", "Cosysop", and "Joe".
  3602.  
  3603. By default, if you press <ESCAPE> instead of picking an entry in the
  3604. list, then nothing will be inserted into the text of your macro.  You
  3605. can indicate that the user MUST pick an entry by putting an asterisk
  3606. (*) at the beginning of the question.  For example, ((*Send Mail
  3607. to?::Sysop,Joe)).  This would make it so that the User MUST choose
  3608. either SYSOP or JOE.
  3609.  
  3610. In the previous examples, SYSOP, COSYSOP and JOE are the text
  3611. responses that are inserted into your macros.  These commands are
  3612. also the same things that are displayed in the listing.  If you want
  3613. to use something else instead of the "return text", you can.  When
  3614. you enter the list entry, add an @description to the end of it.
  3615.  
  3616.     Example: ((Send Mail To?::Sysop@The Head Honcho,Cosysop,Joe))
  3617.  
  3618. One final feature of popup pick-lists allow you to specify a hotkey
  3619. for each entry in the list.  For example, if you wanted the first
  3620. character of each entry to be highlighted (thus allowing you to
  3621. select that character to activate the entry), simply put a tilde (~)
  3622. or an underline (_) before and after the keystroke.  For example
  3623. "_S_ysop" would highlight the "S" in "Sysop".  You can highlight more
  3624. than one character, but only the first one will be the active
  3625. hotkey.  If you omit the second tilde or underline, then the
  3626. remainder of the description will be highlighted.
  3627.  
  3628. NOTE: If you use a tilde or an underline in the text response command
  3629.       (not the description), then those characters will be
  3630.       automatically inserted into your macro when it gets transmitted
  3631.       to the host.  This is probably not what you would want to do.
  3632.       Bottom line, only use hotkey features on list entries where you
  3633.       specify a description!
  3634.  
  3635. If you do not specify a question, then the list will ask you:
  3636. "Choose one of the following:"
  3637.  
  3638. You may specify up to twenty list entries for any one list.
  3639.  
  3640. Examples:
  3641.  
  3642.     ((Send E-Mail to?::Sysop,Joe,Mike))
  3643.     ((*Send E-Mail to?::Sysop@The Head Honcho,Joe,Mike@My Brother))
  3644.     ((::Sysop@_T_he Head Honcho,Joe,Mike@My _B_rother))
  3645.     ((Sysop,Joe,Mike,George))
  3646.  
  3647.  
  3648. ┌────────────────────────────────────────────────────────────────────┐
  3649. │                    2.9 ■ ASCII UPLOAD SETTINGS                     │
  3650. └────────────────────────────────────────────────────────────────────┘
  3651.  
  3652. When you select the ASCII Upload Settings option, the following
  3653. dialog box will appear on your screen:
  3654.  
  3655.                 ╔════════════════════════════════════╗
  3656.                 ║       ASCII Upload Settings        ║
  3657.                 ╟────────────────────────────────────╢
  3658.                 ║                     ┌────┐         ║
  3659.                 ║          Line Delay │ 10 │         ║
  3660.                 ║                     ├────┤         ║
  3661.                 ║     Character Delay │  0 │         ║
  3662.                 ║                     └────┘         ║
  3663.                 ║    ┌──────────┐    ┌──────────┐    ║
  3664.                 ║    │    OK    │    │  CANCEL  │    ║
  3665.                 ║    └──────────┘    └──────────┘    ║
  3666.                 ╚════════════════════════════════════╝
  3667.  
  3668. The significance of each field is as follows:
  3669.  
  3670. ┌────────────┐
  3671. │ LINE DELAY │
  3672. └────────────┘
  3673.  
  3674. Sometimes when uploading ASCII files to a host, it is necessary to
  3675. pause in between each line so that the host can process the data.  If
  3676. you find that data is becoming lost, or garbled by the host when you
  3677. perform an ASCII upload, you may need to increase the Line Delay
  3678. option for ASCII uploads.  You may specify a time value in 1/10ths
  3679. of a second.  Therefore, if you specify a value of 11, it would be a
  3680. 1.1 second pause in between lines.
  3681.  
  3682. ┌─────────────────┐
  3683. │ CHARACTER DELAY │
  3684. └─────────────────┘
  3685.  
  3686. Under some circumstances, when performing an ASCII upload to a host,
  3687. it is necessary to insert pauses in between each character that is
  3688. sent to the host.  This may be necessary in situations where the host
  3689. must process each character as it is sent, rather than every line of
  3690. text sent.  You may specify a time value in 1/10ths of a second.
  3691. Therefore, if you specify a value of 11, it would be a 1.1 second
  3692. pause in between lines.
  3693.  
  3694.  
  3695. ┌────────────────────────────────────────────────────────────────────┐
  3696. │                        3.0 ■ THINGS TO KNOW                        │
  3697. └────────────────────────────────────────────────────────────────────┘
  3698.  
  3699. RIPterm may have been accompanied by a number of icon files.  If so,
  3700. they must be located in the ICONS\ directory.  We recommend that you
  3701. install RIPterm into a directory called RIPTERM.  The ICONS\
  3702. directory would be located under the terminal directory as in the
  3703. following example: C:\RIPTERM\ICONS.  All icon files end in an
  3704. extension of .ICN, .MSK or .HIC.  If the icons are not located in the
  3705. ICONS\ directory, then RIPterm will not load them when instructed to
  3706. do so.  RIPterm will try to sense if the icons are easily locatable,
  3707. and if so, prompt you to move them to the correct location when you
  3708. run RIPterm.
  3709.  
  3710.  
  3711. ┌────────────────────────────────────────────────────────────────────┐
  3712. │                    3.1 ■ ONLINE DEMONSTRATIONS                     │
  3713. └────────────────────────────────────────────────────────────────────┘
  3714.  
  3715. If you would like to see an example of RIPscrip graphics in action,
  3716. you may log-on to one of the following hosts free of charge:
  3717.  
  3718. ┌──────────────────────────────────────────────────────────────┐
  3719. │ 1. ArenaBBS - 32 lines, Galacticomm "The Major BBS" software │
  3720. │    This is TeleGrafix's Tech Support/Entertainment BBS       │
  3721. └──────────────────────────────────────────────────────────────┘
  3722.  
  3723.     PHONE: (714) 840-3520
  3724.  
  3725.     > Create an account for yourself on the system by
  3726.     > typing "NEW" at the log-on prompt.  Answer the
  3727.     > questionnaire and at the main menu, type "RIP ON".
  3728.     > Press <ENTER> to redisplay the menu & away
  3729.     > you go!  This is a subscription service, but you do
  3730.     > not need to subscribe to see an on-line demonstration.
  3731.     > If you discover that your icon files are out of date,
  3732.     > send E-mail to SYSOP or download the file ARENAICN.ZIP
  3733.     > from the RIPICONS file library section.
  3734.  
  3735. ┌──────────────────────────────────────────────────────────────┐
  3736. │ 2. Nova Central - 4 lines, ResNova "Nova Link Professional"  │
  3737. │    This is ResNova's Technical Support BBS                   │
  3738. └──────────────────────────────────────────────────────────────┘
  3739.  
  3740.     PHONE: (714) 840-8641
  3741.  
  3742.     > This is ResNova's technical support BBS.  It is using
  3743.     > the Nova Link Professional host for the Apple
  3744.     > Macintosh.  Simply sign-up on the system and at the
  3745.     > Main Menu, choose the "RIPscrip Graphics" option
  3746.     > for an on-line demonstration.
  3747.  
  3748. ┌──────────────────────────────────────────────────────────────┐
  3749. │ 3. RIP Demo Midwest - 2 line TBBS system.  This BBS is a     │
  3750. │    full RIP Demo System.                                     │
  3751. └──────────────────────────────────────────────────────────────┘
  3752.  
  3753.     PHONE: (708) 978-2777
  3754.  
  3755.     > Sign-up in "text mode" if you do not have the RDM
  3756.     > icons.  Download the system icons and away you
  3757.     > go.  Be sure to see the Message Forums and other areas.
  3758.  
  3759.  
  3760. ┌────────────────────────────────────────────────────────────────────┐
  3761. │               APPENDIX A ■ TROUBLESHOOTING/PROBLEMS                │
  3762. └────────────────────────────────────────────────────────────────────┘
  3763.  
  3764. Modem communications is not a simple thing.  There are many different
  3765. technical factors that can affect RIPterm, making it work
  3766. erratically, or unreliably.  This section is intended to try to help
  3767. you figure out what's wrong and get yourself up and running as
  3768. quickly as possible.
  3769.  
  3770. Check through the remainder of this section to see if the particular
  3771. problem you're having is addressed.  If you are having some sort of
  3772. difficulty not covered below (or the instructions that follow do not
  3773. resolve the problem), contact the TeleGrafix Technical Support
  3774. department as noted in APPENDIX B.
  3775.  
  3776.  
  3777. ┌────────────────────────────────────────────────────────────────────┐
  3778. │                   A.1 ■ "BUS" MOUSE DOESN'T WORK                   │
  3779. └────────────────────────────────────────────────────────────────────┘
  3780.  
  3781. Make sure your mouse driver is loaded into memory before you run
  3782. RIPterm.  Without a mouse driver loaded, RIPterm will not be able to
  3783. use your mouse.  Consult the manual that came with your mouse under
  3784. the section INSTALLATION or SOFTWARE INSTALLATION.
  3785.  
  3786. Most mouse drivers come in two flavors, a .SYS file, or a TSR program
  3787. ending in a .COM file extension.  A .SYS file must be loaded into
  3788. your C:\CONFIG.SYS file as any other device driver.
  3789.  
  3790. An example of loading your MOUSE.SYS driver would be as follows:
  3791.  
  3792.  
  3793.     CONFIG.SYS file:
  3794.  
  3795.         FILES=40
  3796.         BUFFERS=40
  3797.         DEVICE=C:\MOUSE\MOUSE.SYS
  3798.  
  3799. If your mouse came only with a MOUSE.COM driver, then you must edit
  3800. your C:\AUTOEXEC.BAT file and add a line calling mouse driver so that
  3801. it can be loaded into memory each time your system boots up.  Add a
  3802. line similar to the one that follows:
  3803.  
  3804.     AUTOEXEC.BAT file:
  3805.  
  3806.         PATH=C:\;C:\DOS;C:\MOUSE
  3807.         PROMPT $P$G
  3808.         MOUSE
  3809.  
  3810. Modifications may vary - consult your Mouse Manual.
  3811.  
  3812.  
  3813. ┌────────────────────────────────────────────────────────────────────┐
  3814. │                 A.2 ■ "SERIAL" MOUSE DOESN'T WORK                  │
  3815. └────────────────────────────────────────────────────────────────────┘
  3816.  
  3817. If you are using a serial mouse, and it is not responding, you might
  3818. be experiencing a "conflict" between your modem serial port, and your
  3819. mouse serial port.  Under most circumstances, a conflict like this
  3820. will NOT arise in normal applications programs that don't use both a
  3821. mouse and a modem simultaneously.
  3822.  
  3823. Below you should find a list of correct and incorrect modem/mouse
  3824. configurations.
  3825.  
  3826.     CORRECT COMBINATIONS        INCORRECT COMBINATIONS
  3827.     =======================     =======================
  3828.     Modem=COM1 / Mouse=COM2     Modem=COM1 / Mouse=COM3
  3829.     Modem=COM1 / Mouse=COM4     Modem=COM2 / Mouse=COM4
  3830.     Modem=COM2 / Mouse=COM1     Modem=COM3 / Mouse=COM1
  3831.     Modem=COM2 / Mouse=COM3     Modem=COM4 / Mouse=COM2
  3832.     Modem=COM3 / Mouse=COM2
  3833.     Modem=COM3 / Mouse=COM4
  3834.     Modem=COM4 / Mouse=COM1
  3835.     Modem=COM4 / Mouse=COM3
  3836.  
  3837. If you are knowledgeable about IBM-PC hardware, and how to install
  3838. add-on cards, you may be able to circumvent the above recommended
  3839. port combinations.  To do this will require removing the PC cover and
  3840. changing the interrupt (IRQ) setting of either the modem serial port,
  3841. or the mouse serial port (if possible).  In order to get both the
  3842. mouse and the modem operating properly, the two serial ports must use
  3843. different IRQ settings!  If none of this makes sense to you, we would
  3844. recommend sticking to the above recommended layouts.
  3845.  
  3846.  
  3847. ┌────────────────────────────────────────────────────────────────────┐
  3848. │                    A.3 ■ MODEM ISN'T RESPONDING                    │
  3849. └────────────────────────────────────────────────────────────────────┘
  3850.  
  3851. If you have a serial mouse, you may be experiencing a conflict
  3852. between your mouse and your modem.  A serial mouse can be identified
  3853. if it plugs into one of your IBM-PC communications ports COM1 through
  3854. COM4.  Not all systems have 4 COM ports, so your system may be
  3855. somewhat different.  A serial mouse typically has a 25-pin connector
  3856. shaped like an elongated "D".  Another type of serial mouse has a
  3857. 9-pin connector also shaped like a "D".
  3858.  
  3859. Check to make sure you modem is plugged in and turned on (if it is an
  3860. external modem).  Make sure that the serial cable connecting the
  3861. modem to your computer is securely fastened to the proper COM port.
  3862.  
  3863. Check your modem settings to make sure they are set correctly.  You
  3864. may edit these settings by pressing ALT-O (Modem Options).  Things
  3865. you should check for:
  3866.  
  3867.     1.  Make sure it is set for the correct port (COM1 - COM4)
  3868.  
  3869.     2.  Make sure the baud rate is set to a speed your modem
  3870.         can support (or lower).  Settings for this would be
  3871.         300, 1200, 2400, 9600, 19,200 baud.
  3872.  
  3873. Consult SECTION 4.1 above to determine if you are using an
  3874. incorrect COM port configuration for your serial mouse and your
  3875. modem.
  3876.  
  3877.  
  3878. ┌────────────────────────────────────────────────────────────────────┐
  3879. │                 A.4 ■ NOISY TELEPHONE CONNECTIONS                  │
  3880. └────────────────────────────────────────────────────────────────────┘
  3881.  
  3882. If you get a noisy telephone connection, the graphics that you see
  3883. might become garbled in some fashion.  Since RIPterm does more than
  3884. simply display pictures on the screen, this can disturb underlying
  3885. (invisible) operations as well.
  3886.  
  3887. Solutions:  Hang-up and try calling again.  Often times, this can
  3888.             resolve the problem.
  3889.  
  3890.             Long distance connections are typically the noisiest
  3891.             connections.  Check with your operator and find out if
  3892.             you can use a different "Long Distance Carrier" like MCI,
  3893.             AT&T, US Sprint, etc.
  3894.  
  3895.             Use an Error-Correcting modem (provided the host you are
  3896.             calling can support one).
  3897.  
  3898.  
  3899. ┌────────────────────────────────────────────────────────────────────┐
  3900. │                   APPENDIX B ■ TECHNICAL SUPPORT                   │
  3901. └────────────────────────────────────────────────────────────────────┘
  3902.  
  3903. This program is as bug-free as possible.  In all reality, there are
  3904. most likely some bugs that have not as of yet been discovered.
  3905. Should any bugs be discovered, they should be reported to the authors
  3906. as soon as possible at the following address:
  3907.  
  3908.           ┌───────────────────────────────────────────────┐
  3909.           │        TeleGrafix Communications, Inc.        │
  3910.           │            16458 Bolsa Chica #15              │
  3911.           │          Huntington Beach, CA 92649           │
  3912.           │                                               │
  3913.           │ Voice .. (714) 379-2131                       │
  3914.           │ Fax .... (714) 379-2132                       │
  3915.           │ Data ... (714) 840-3520 - ArenaBBS [32 lines] │
  3916.           └───────────────────────────────────────────────┘
  3917.  
  3918.    Authors: Jeff "Covenant" Reeder
  3919.             (CEO: Senior Programmer)
  3920.  
  3921.             Mark "Necron" Hayton
  3922.             (President: Programmer)
  3923.  
  3924.             Jim "Bergie" Bergman
  3925.             (Vice President: Programmer)
  3926.  
  3927.             Mara "Kytty" Ward
  3928.             (Chief Operations Officer: Production)
  3929.  
  3930.  
  3931. ┌────────────────────────────────────────────────────────────────────┐
  3932. │                   APPENDIX C ■ RIPscrip Products                   │
  3933. └────────────────────────────────────────────────────────────────────┘
  3934.  
  3935. For more information about RIPscrip based products, contact:
  3936.  
  3937.     TeleGrafix Communications, Inc.
  3938.     16458 Bolsa Chica, #15
  3939.     Huntington Beach, CA 92649
  3940.  
  3941.     Voice: (714) 379-2131
  3942.     Fax  : (714) 379-2132
  3943.     Data : (714) 840-3520 ArenaBBS [32 lines] running The Major BBS
  3944. 
  3945.